Skip to content

About

Automatically records movies from your watchlist onto your DVR, with library checks, localized title matching, and support for IMDb, TMDB, Trakt, Plex, Jellyfin, and TVHeadend.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

watchlist2dvr 📺🎬

Build Release Docker Image Docker Pulls Node TypeScript

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.

What it does

  • 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.

How it works

  1. Collect watchlist items from your configured sources.
  2. Skip titles already present in your library.
  3. Normalize and localize titles through TMDB.
  4. Find upcoming airings in the EPG.
  5. Schedule the earliest valid match, unless dry_run is enabled.

Quick start

Deploy with Docker Compose:

cp config.yaml.example config.yaml
docker compose up -d

The 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.

Documentation

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.100

Contributing

See CONTRIBUTING.md for project structure, development setup, commit conventions, and how to cut a release.


Roadmap

  • IMDb auto-download via session cookie (imdb_auto source)
  • Public IMDb lists — charts and public user lists (imdb_public_lists source)
  • Trakt OAuth flow (currently public watchlist / API key only)
  • Manual match override via web UI
  • Notifications on successful schedule — ntfy push alerts (notifications config 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

About

Automatically records movies from your watchlist onto your DVR, with library checks, localized title matching, and support for IMDb, TMDB, Trakt, Plex, Jellyfin, and TVHeadend.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages