-
Notifications
You must be signed in to change notification settings - Fork 0
Sources
A source is where channels come from. Add one from the Sources page.
| Kind | You provide | Notes |
|---|---|---|
| M3U / M3U8 | a playlist URL | most also advertise their XMLTV feed (x-tvg-url), which tvtimes adopts automatically |
| Xtream Codes | server URL + username + password | credentials are encrypted at rest; stream URLs are rebuilt on demand and never stored in channel rows |
| Stalker portal | portal URL + MAC | the short-lived create_link is resolved lazily, not at ingest |
| HDHomeRun | nothing, or the tuner's address | see below |
Drag the rows to reorder them — the guide lists channels source by source in that order.
Add a source, choose HDHomeRun:
-
Same network as the server, not in Docker's bridge: leave the address blank to auto-discover.
-
tvtimes running in Docker (the usual case): the bridge network can't receive discovery broadcasts — enter the tuner's address, e.g.
http://192.168.1.50. Find it at https://my.hdhomerun.com or in your router. -
Tuner on a different network from the server: run the connector there and pair it from Settings → Connectors:
docker run --network host issinoho1969/tvtimes-connector \ run --pair <code> --server https://tv.example.com
SiliconDust guide data (api.hdhomerun.com) is picked up automatically once the
tuner reports a DeviceAuth.
A few playlists (some Pluto proxies) don't advertise an XMLTV feed, so the
source loads channels but no programmes. Open the source's EPG panel and
paste an XMLTV URL (.xml or .xml.gz) into Attach XMLTV. It's matched
tenant-wide across every channel by tvg-id / name, and you can remove it again
from the same panel. A LAN URL you've added to TVTIMES_FETCH_ALLOWLIST is
accepted here too.
The worker re-fetches each source on its interval (channels ~6 h, EPG ~12 h, jittered). Refresh on the source forces an immediate full rebuild — channels are reconciled in place by a stable key so unchanged channels keep their id and their programmes.
Guide times render in the channel's zone: a per-source timezone override, else your account default (captured from the browser at signup). On top of that, a per-channel offset is nudged from a programme's info panel — line a US-West feed up with an East-coast EPG without touching its East sibling. See also Export Feeds, which bakes this correction into the exported XMLTV.