Deluge Cleanup

deluge-cleanup

Torrent cleanup for PHATT-RAID. Checks seeding rules per tracker, verifies content exists in Plex and in the corresponding *arr (Sonarr/Radarr), outputs safe-to-remove list. Optionally executes removal via Deluge JSON-RPC.

Script

scripts/deluge_cleanup.py

Usage

cd /root/.openclaw/workspace/skills/deluge-cleanup/scripts

# Dry run — show what's safe to remove right now
python3 deluge_cleanup.py

# Full report — all categories (safe, still seeding, no plex, no arr, unknown tracker)
python3 deluge_cleanup.py --report

# JSON output (for piping or structured use)
python3 deluge_cleanup.py --report --json

# Actually remove safe torrents + data files
python3 deluge_cleanup.py --remove

Always run dry run first. Always confirm before --remove.

Tracker Rules

To add a tracker: edit TRACKER_RULES dict or NEVER_REMOVE set at the top of the script.

Classification

Allowed Labels

Only torrents with these labels are processed (these are applied by *arr apps):

• tv-sonarr or sonarr — TV series (checked against Plex shows and Sonarr; episode‑level verification)
• radarr — Movies (checked against Plex movies and Radarr)

All other labels (music, books, lidarr, etc.) are skipped. This ensures we only consider video content.

Matching & Verification Logic

1. Plex matching (movies vs shows)

   • Preloads all movies and shows (separate indexes)
   • Normalizes titles (ASCII, lowercase, strip punctuation)
   • Matches via exact or substring containment
   • Case‑insensitive

2. Sonarr/Radarr verification

   • For TV (tv-sonarr/sonarr):
     • Find series by normalized title or by path prefix (save_path starts with series path)
     • If torrent filename contains SxxEyy, verify that specific episode exists in Sonarr (episodeFileId present or monitored)
   • For Movies (radarr):
     • Find movie by normalized title OR by path prefix
   • Both series/movie and episode (if applicable) must exist. If unreachable, treated as NO_ARR.

3. Safety chain

   • Only torrents satisfying all three pass: seeding rule + Plex + *arr existence → SAFE
   • Anything else lands in a review bucket (NO_PLEX, NO_ARR, etc.)

Episode‑level verification note

TV torrents are checked at the episode level, not just series level. This prevents deletion of torrents where the series exists in Sonarr but the specific episode file was never added (e.g., manually imported, or season pack not split). Those appear as NO_ARR for manual review. This is intentionally strict; if in doubt, keep the data.

Credentials (already hardcoded as defaults)

• Deluge: http://10.0.0.100:8112 / password in TOOLS.md
• Plex: http://10.0.0.100:32400 / token C6DFr9z3gxx7CvyxsByc
• Sonarr: http://10.0.0.100:8989/sonarr / API key a04acb1fcde0450091e1f23c7a269c9b
• Radarr: http://10.0.0.100:7878/radarr / API key 861dc41877ff4bb7ae17c113fc89c361

Override via env vars: DELUGE_URL, DELUGE_PASS, PLEX_URL, PLEX_TOKEN, SONARR_URL, SONARR_KEY, RADARR_URL, RADARR_KEY

Notes

• remove_data=True is always used — this deletes the actual files from the download dir. The Plex library copy (hardlinked or already imported) is unaffected.
• Error‑state torrents that have met their seeding requirement are treated as SAFE if Plex confirms the content and it's still in the appropriate *arr.
• The Plex library load may take a few seconds on first run; it's cached in memory for the duration.
• Run periodically (weekly cron or on‑demand) to stay on top of seeding obligations.