Skip to content

Configuration

Julien Hoffmann edited this page May 18, 2026 · 1 revision

Configuration

This page documents the config.yaml structure. Use config.yaml.example in the main repo as the baseline, then fill in the sections you need.

Top-level structure

sources:
  - type: imdb_auto
    user_id: "ur12345678"
    cookie: "YOUR_AT_MAIN_COOKIE_VALUE"
    lists:
      - watchlist
      - ratings

library:
  - type: plex
    url: http://plex:32400
    token: "YOUR_PLEX_TOKEN"

tmdb:
  api_key: "YOUR_TMDB_API_KEY"

matching:
  preferred_language: de
  fallback_languages:
    - en

dvr:
  type: tvheadend
  url: http://tvheadend:9981

state:
  redis_url: redis://redis:6379

scheduler:
  mode: polling
  interval_minutes: 60
  dry_run: true

web:
  enabled: true
  port: 3000

Sources

At least one source is required. See Sources for the source-specific behavior and examples.

Library

Use library when you want the app to skip movies you already own.

  • plex uses a Plex server URL plus token.
  • jellyfin uses a Jellyfin server URL plus API key.

You can configure one or more library checkers.

TMDB

TMDB is required for title localization and matching support.

  • api_key is required.
  • sync_watchlist.session_id is optional and mirrors collected IMDb IDs into your TMDB watchlist.

Matching

The matching block controls language preference and the year/fuzzy behavior.

  • preferred_language defaults to a two-letter ISO code such as de.
  • fallback_languages are checked in order.
  • strict_year_match controls how much the year matters when EPG data is missing.
  • year_tolerance allows a small year range when EPG data exists.
  • fuzzy_enabled enables Fuse.js as a last resort.

DVR

Choose the DVR backend you use.

  • tvheadend is the default backend.
  • plex works with Plex Pass Live TV and DVR.
  • jellyfin works with Jellyfin Live TV.

The exact fields differ slightly by backend. See the examples in config.yaml.example and the source code for the adapter-specific details.

State

state.redis_url points at Redis and is used for idempotency, caches, and scheduler state.

Scheduler

  • mode: polling runs on a fixed interval.
  • mode: oneshot runs once and exits.
  • dry_run: true is the safest starting point because it logs matches without writing to the DVR.

Web

The dashboard is enabled by default on port 3000.

Notifications

Notification support is optional. The main supported notifier is ntfy.

Example:

notifications:
  - type: ntfy
    url: https://ntfy.sh/your-topic
    token: "YOUR_NTFY_ACCESS_TOKEN"

Clone this wiki locally