Repository navigation
Operations
This page covers the pieces you use after configuration: dashboard, notifications, sync, caching, and deployment.
The dashboard runs on the configured web port, usually http://localhost:3000.
It includes:
- Watchlist status and search/filtering
- Upcoming recordings or queued DVR entries
- Run history
- Debug views for cache and matching state
- Source status and manual refresh controls
If enabled, the app mirrors collected IMDb IDs into your TMDB watchlist each run.
Setup is a one-time TMDB session flow:
- Request a token from the TMDB auth API.
- Approve it in the browser.
- Exchange it for a session ID.
- Put the resulting
session_idundertmdb.sync_watchlist.
The supported notification provider is ntfy.
Use it when you want a push alert every time a recording is scheduled.
notifications:
- type: ntfy
url: https://ntfy.sh/your-topicThe app uses Redis for library indexes, source state, scheduled-item state, and TMDB lookups. EPG data itself stays live.
The default compose setup runs the app and Redis together. Mount config.yaml and the data/ directory, then start with docker compose up.
The /api/stats endpoint is designed for the Gethomepage customapi widget if you want a compact overview panel.