semvec/pypi-packages huggingface dataset:
mediascan 0.1.7
A Python package for scanning and organizing media files.
Requires Python: >=3.7

# MediaScan

MediaScan is a Python tool for organizing media files. It scans directories, interprets file names, and organizes movies and TV shows into a structured library.

## Features

- Automatically categorizes movies and TV shows
- Supports various naming conventions and file formats
- Configurable output directory structure
- Multiple actions: link, copy, or move files

## Installation

```bash
pip install mediascan
```

## Usage

### Command Line Interface

Generate a default config file:

```bash
mediascan --generate-config
```

Run MediaScan:

```bash
mediascan --input-path ~/Downloads --output-dir ~/MediaLibrary --action link
```

### Python

```python
from mediascan import MediaScan

scanner = MediaScan(
    input_path="~/Downloads",
    output_dir="~/MediaLibrary",
    action="symlink",
)

scanner.scan()
```

## License

CC0. Do whatever.