dedupe-episodes 0.1.1

Dedupe TV episodes by quality. Keep best (resolution + PROPER/REPACK), delete worse + sidecar files.

dedupe-episodes

Scan a TV show library, detect duplicate episodes at different qualities, keep the best, delete the rest (and their sidecar .nfo / -thumb.jpg / .srt files).

Quality ranking

1. Resolution: 2160p > 1080p > 720p > 480p
2. Same resolution: PROPER / REPACK beats plain
3. Tied (same resolution AND same proper flag): WARN + skip — manual review

Resolution always outranks proper. So a 2160p plain release beats a 1080p Proper, but a 1080p Proper beats a plain 1080p.

Install

CLI app — recommended way is to install it isolated from your system Python:

# isolated install with uv (recommended)
uv tool install dedupe-episodes

# isolated install with pipx
pipx install dedupe-episodes

# run once without installing
uvx dedupe-episodes /path/to/shows
pipx run dedupe-episodes /path/to/shows

# or plain pip (into current env)
pip install dedupe-episodes

Usage

dedupe-episodes /path/to/shows           # dry-run (default — prints plan, deletes nothing)
dedupe-episodes /path/to/shows --delete  # actually delete losers + their sidecars
dedupe-episodes /path/to/shows --ext mkv --ext mp4   # restrict scanned extensions

Episodes are grouped by (parent directory, season, episode), parsed via guessit. Sidecars are siblings whose filename starts with the video stem followed by ., -, or _.

Develop locally

git clone https://github.com/asm0dey/dedupe-episodes
cd dedupe-episodes
uv sync
uv run dedupe-episodes /path/to/shows

Tests

uv run pytest

53 tests, all run on an in-memory fake filesystem via pyfakefs — no real disk I/O, no host pollution.