video-sweep 0.1.0

Minimal CLI tool to find, classify, rename, and move video files.

video-sweep

Minimal CLI tool to find, classify (movie/series), rename, and move video files to user-specified locations. Optionally, clean up non-video files.

Features

• Finds video files (.mp4, .mkv, .avi)
• Classifies as movie or series
• Renames and moves files
  • Movies: Title [Year].ext to the movie output folder
  • Series: SeriesName SxxEyy.ext to series_output/SeriesName/Season N/
    • Example: SeriesName (2014) - S04E01 -EpisodeTitle.mkv → SeriesName S04E01.mkv in series_output/SeriesName/Season 4/
• Cleans up non-video files (optional)
• All paths provided via CLI arguments or config
• Basic error handling and console warnings for skipped files
• Dry run mode for safe preview
• Console table output with color-coded type column (movies: yellow, series: blue)

Installation

pip install video-sweep

Usage

video-sweep --source <source_folder> --series-output <series_folder> --movie-output <movie_folder> [--clean-up] [--dry-run] [--config <file>] [--init-config <file>]

• --clean-up: Permanently delete non-video files in the source folder (shows a table of files to be deleted).
• --dry-run: Preview all actions without moving or deleting any files (safe to use with or without --clean-up).
• --config <file>: Load options from a TOML config file. If not specified, config.toml in the current directory is used if present.
• --init-config <file>: Generate a sample TOML config file at the given path and exit.

Example config.toml

source = "D:/Downloads"
series_output = "D:/Media/Series"
movie_output = "D:/Media/Movies"
clean_up = true
dry_run = false

Examples

video-sweep --source "D:/Downloads" --series-output "D:/Media/Series" --movie-output "D:/Media/Movies"

# Use a config file
video-sweep --config config.toml

# Generate a sample config file
video-sweep --init-config config.toml

# Preview all actions (no files moved or deleted)
video-sweep --source "D:/Downloads" --series-output "D:/Media/Series" --movie-output "D:/Media/Movies" --dry-run

# Move/rename video files and permanently delete non-video files
video-sweep --source "D:/Downloads" --series-output "D:/Media/Series" --movie-output "D:/Media/Movies" --clean-up

# Preview all actions, including cleanup (no files moved or deleted)
video-sweep --source "D:/Downloads" --series-output "D:/Media/Series" --movie-output "D:/Media/Movies" --clean-up --dry-run

License

MIT