Skip to content

Search Watchlist and Reminders

Iain Smith edited this page Sep 2, 2026 · 3 revisions

Search, Watchlist and Reminders

Search

The Search page matches programme titles and sub-titles across every channel for roughly the next two weeks, case-insensitive, earliest airing first. Toggle Films only to narrow it. Each result opens the programme panel.

Watchlist

From any programme panel — reached from a Tonight card, a search result or a guide cell — you get two toggles:

  • Remind me — this specific airing (channel + start time).
  • Watch this titleevery future airing whose title matches, on any channel.

Both appear on the Watchlist page, where a title watch shows its next upcoming match. Remove an item there or by toggling it off in the panel. The watchlist is per user, so a shared household account can have one each.

Reminders

A background job runs every 5 minutes. For each watchlist item whose airing is about to start, it notifies you ~15 minutes before, then records that it sent — so a title watch never double-fires for the same broadcast.

  • Email goes to your verified account address; unverified accounts are skipped. It's fail-open (a provider error is logged with the full body and the job moves on) and with TVTIMES_EMAIL_PROVIDER=console it's only logged — set a real provider (Email) if you want it delivered.
  • Push goes to any notification target with Reminders enabled, once per airing regardless of how many people on the account watch it.

Adding or removing a watchlist entry can also send a push if you turn on the matching activity notification — those are push-only and off by default.

Recording it instead

If you run tvdinner on a box at home, --record-watchlist on a tvtimes:// source turns this watchlist into scheduled recordings — press Remind me here and it records there. It reads the /api/exports/watchlist.json feed that comes with your export token; see Export Feeds for the details.

Clone this wiki locally