Skip to content

Operations

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

Operations

This page covers the pieces you use after configuration: dashboard, notifications, sync, caching, and deployment.

Web dashboard

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

TMDB watchlist sync

If enabled, the app mirrors collected IMDb IDs into your TMDB watchlist each run.

Setup is a one-time TMDB session flow:

  1. Request a token from the TMDB auth API.
  2. Approve it in the browser.
  3. Exchange it for a session ID.
  4. Put the resulting session_id under tmdb.sync_watchlist.

Notifications

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-topic

Caching

The app uses Redis for library indexes, source state, scheduled-item state, and TMDB lookups. EPG data itself stays live.

Docker Compose

The default compose setup runs the app and Redis together. Mount config.yaml and the data/ directory, then start with docker compose up.

Homepage widget

The /api/stats endpoint is designed for the Gethomepage customapi widget if you want a compact overview panel.

Clone this wiki locally