1 Using the CLI
Xena Rathon edited this page 2026-06-28 19:10:45 -04:00

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.