Repository navigation
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.
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: 3000At least one source is required. See Sources for the source-specific behavior and examples.
Use library when you want the app to skip movies you already own.
-
plexuses a Plex server URL plus token. -
jellyfinuses a Jellyfin server URL plus API key.
You can configure one or more library checkers.
TMDB is required for title localization and matching support.
-
api_keyis required. -
sync_watchlist.session_idis optional and mirrors collected IMDb IDs into your TMDB watchlist.
The matching block controls language preference and the year/fuzzy behavior.
-
preferred_languagedefaults to a two-letter ISO code such asde. -
fallback_languagesare checked in order. -
strict_year_matchcontrols how much the year matters when EPG data is missing. -
year_toleranceallows a small year range when EPG data exists. -
fuzzy_enabledenables Fuse.js as a last resort.
Choose the DVR backend you use.
-
tvheadendis the default backend. -
plexworks with Plex Pass Live TV and DVR. -
jellyfinworks 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.redis_url points at Redis and is used for idempotency, caches, and scheduler state.
-
mode: pollingruns on a fixed interval. -
mode: oneshotruns once and exits. -
dry_run: trueis the safest starting point because it logs matches without writing to the DVR.
The dashboard is enabled by default on port 3000.
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"