Using the CLI
After installing and creating config.py:
source venv/bin/activate
python plex_warnings.py --dry-run # preview (safe — writes nothing)
python plex_warnings.py # process all configured libraries
python plex_warnings.py --movie "Midsommar"
python plex_warnings.py --show "Game of Thrones" # uses TV_WARNING_LEVELS
python plex_warnings.py --clear # remove everything this tool added
python plex_warnings.py --clear-cache # force fresh DTDD lookups
python plex_warnings.py --list-topics # print every topic name, for filtering
Run on a schedule (cron)
crontab -e
# nightly at 3am:
0 3 * * * cd ~/DoesTheDogWatchPlex && venv/bin/python plex_warnings.py >> dtdd.log 2>&1
Notes
- Idempotent — re-running replaces the existing block, it doesn't stack.
- Reversible —
--clear restores the original summaries.
- TV episode level makes one API call per episode; start with
series + season (set in Configuration) and add episode once you're happy with the output.