Home

tvtimes

A modern, self-hosted TV schedule (EPG) for your home lab — a colourful set-top-box-style guide, passkeys-first accounts, and one Docker Compose stack you run on your own hardware. Not a hosted service.

You create an account, connect your TV sources (playlists, Xtream, Stalker, HDHomeRun), and land on a Tonight overview backed by a fast virtualised guide grid with channel logos, genres, release years and a cinematic TMDB panel.

Get started

1. Installation — the two-file Docker Compose quickstart
2. Configuration — the environment variables that matter
3. Sources — connect a playlist / tuner and get guide data flowing
4. Reverse Proxy and HTTPS — needed for passkeys off localhost

Using it

• Guide and Tonight — the landing dashboard and the full grid
• Search Watchlist and Reminders — find a film, get a heads-up before it airs
• Export Feeds — hand your whole line-up to Jellyfin / Plex / TiviMate
• Enrichment (TMDB) — backdrops, cast, ratings for films
• Accounts and Security — passkeys, 2FA, sessions
• Email — verification links and reminder delivery
• Notifications — push targets (Gotify / ntfy / …) and activity alerts
• Pairing With tvdinner — the desktop player: whole line-up, watchlist recording, watched state, favourites

Operating it

• Upgrades and Backups — what to back up, how to upgrade
• Troubleshooting — the common "why isn't this working" answers
• Architecture — how the pieces fit, for contributors

Links

• Source & issues: https://github.com/issinoho/tvtimes
• Images: issinoho1969/tvtimes on Docker Hub, mirrored to ghcr.io/issinoho/tvtimes
• Website: https://issinoho.github.io/tvtimes/

This wiki is operator/user documentation. Contributor conventions and invariants live in CLAUDE.md; the environment reference is docs/deploy.md.