Automatically records movies from your watchlist and other movie sources onto your DVR.
It resolves localized titles, skips items already in your library, and schedules the earliest matching airing. The code supports IMDb watchlists and ratings, public IMDb lists, TMDB lists, Trakt, or manual CSV input.
- Pulls movies from one or more sources.
- Checks Plex or Jellyfin to skip items you already own.
- Resolves titles through TMDB for your preferred language.
- Matches against TVHeadend, Plex DVR, or Jellyfin Live TV.
- Keeps runs idempotent with Redis-backed state.
- Shows progress in a web dashboard (watchlist status, upcoming recordings, run history, cache debug tools) and can send ntfy notifications.
- Collect watchlist items from your configured sources.
- Skip titles already present in your library.
- Normalize and localize titles through TMDB.
- Find upcoming airings in the EPG.
- Schedule the earliest valid match, unless
dry_runis enabled.
Deploy with Docker Compose:
cp config.yaml.example config.yaml
docker compose up -dThe compose file uses irizzu/watchlist2dvr:latest and pulls the image from Docker Hub automatically. Start by filling in the required config values in config.yaml: at minimum a source, tmdb.api_key, one library checker if you want ownership checks, and a DVR backend.
If you also want to convert recorded .ts files into .mkv, this pairs well with ts2mkv, a Docker-based tool that preserves folder structure and chooses remux or encode paths with hardware fallback.
The wiki holds the detailed docs so this README can stay short:
For a starting point, copy config.yaml.example and then use the wiki for the full field-by-field explanation.
config.yaml is gitignored — never committed.
If TVHeadend, Plex, or Jellyfin are accessed via Tailscale MagicDNS, add the Tailscale DNS resolver to the compose service:
dns:
- 100.100.100.100See CONTRIBUTING.md for project structure, development setup, commit conventions, and how to cut a release.
- IMDb auto-download via session cookie (
imdb_autosource) - Public IMDb lists — charts and public user lists (
imdb_public_listssource) - Trakt OAuth flow (currently public watchlist / API key only)
- Manual match override via web UI
- Notifications on successful schedule — ntfy push alerts (
notificationsconfig block) - Series / episode support
- TMDB lists / collections / named endpoints source (
tmdb_lists) - Plex DVR backend (EPG via Plex Live TV + subscriptions API)
- Jellyfin DVR backend