tvtimes For HDHomeRun owners

The pairing

Plan anywhere.
Record at home.

Your tuner sits at home on the aerial, where it has to. You don't. Flag a film from a phone on the bus, and the box on your network has it scheduled within fifteen minutes — off the same guide, with the same clock corrections, from a line-up that includes every other source you own.

Wherever you are

You flag it

The guide in a browser — your HDHomeRun channels merged with any M3U or Xtream sources, de-duplicated, times already corrected. Press Remind me.

Your server

tvtimes holds the plan

Ingests the line-up and guide, applies per-channel clock corrections, and publishes the watchlist as JSON behind one token.

On your network

tvdinner records it

Polls that watchlist every 15 minutes and schedules the airing. --record-watchlist

One export token covers all of it — no second credential, no per-feature pairing

Why bother

What a tuner alone won't do

None of this is a criticism of the hardware. An HDHomeRun is a very good tuner. It is just only a tuner.

The guide is behind a subscription

SiliconDust's own listings need a DVR subscription. tvtimes takes XMLTV from wherever you like — a provider's feed, EPG.best, a self-hosted grabber — and matches it to your tuner's channels itself.

Your tuner and your IPTV sources never meet

Aerial channels live in one app, a provider's M3U in another. tvtimes merges them into a single ordered grid, de-duplicated, and keys every channel by its own id — so an East and West feed sharing a tvg-id upstream still resolve to the right listings downstream.

A feed with the wrong clock stays wrong

Set a per-channel offset once and every export writes times already shifted into that channel's zone with the correct +ZZZZ. Nothing downstream has to know, and correcting it later re-dates history rather than stranding it.

Nothing follows you out of the house

Watchlists, reminders and what you have already seen sit on a server you reach from anywhere, not in an app pinned to the living room.

The loop

Four things travel, and they travel both ways

Each is one flag on tvdinner and one feed on tvtimes. Turn on the ones you want; the rest stay off.

What Direction How it behaves
The line-up playlist.m3u + epg.xml to the box Every enabled source as one playlist and one guide. Provider credentials stay on the server and never appear in the file.
Your watchlist --record-watchlist to the box Polled every 15 minutes. Un-flag something and its pending recording goes too. Recordings you scheduled by hand are never touched.
What you watched --report-watch-state back to the guide Sent as plain start/stop intervals, never “programme X”. A guide refresh or a corrected clock updates what counts as watched with nothing re-reported.
Favourites --sync-favourites to the box Stars set in the browser show in the player's guide. Additive and one-way on purpose — un-starring here won't delete one you set there.

Be clear about this

What it isn't

This is not remote streaming

  • An HDHomeRun's streams are LAN addresses. tvtimes hands a player the channel and redirects to the tuner — which resolves on your network and not outside it. Planning travels; the video does not. If you want to watch away from home, that is a VPN or a relay, and neither is part of this.
  • tvdinner has no background service. It has to be running when a recording's time arrives. It is a player that can record, not a headless DVR.
  • Nothing in the browser plays video. tvtimes is where you plan. Playing happens in tvdinner, or in whichever tuner app you point at the same two feed URLs — it works just as well with Jellyfin, Plex, Emby, TiviMate or Threadfin.

Getting there

Three moves

Both halves are self-hosted and yours. If the tuner is on a different network from the server, a small agent bridges it — outbound HTTPS only, nothing listening, no ports opened.

01

Point tvtimes at the tuner

Add an HDHomeRun source, plus any M3U or Xtream sources you already have. Attach an XMLTV guide if your feed doesn't name its own.

02

Generate the feed links

Settings → Export feeds. You get one token and a tvtimess:// URL that stands in for the whole account.

03

Start the box at home

One command, with the flags you want from the table above. It picks up the line-up, the guide and your watchlist together.