TV GUIDE
TV Guide for Home Assistant

Your TV evening.
At a glance.

What’s on TV right now? TV Guide brings your television schedule directly into Home Assistant – with your channels, a watchlist and reminders for your favourite programmes.

Now or tonight

Jump to what’s on now, 18:00, 20:15 or 22:00. You can also choose another available day and the time you want.

Your personal channel list

Prepared main channels for Austria, Belgium, Denmark, France, Germany, the Netherlands, Norway, Sweden, Switzerland and the United Kingdom, plus other available channels. Choose your favourites and arrange them in your preferred order.

Reminders & automations

Save programmes, get Home Assistant reminders and use optional sensors in your own dashboards and automations.

Set up in a few steps

You need Home Assistant with the App/Add-on Store, for example Home Assistant OS.

  1. Add the repository using the button above. Alternatively, open Repositories in the store and add https://github.com/criticallimit/TV-Guide.
  2. Install and start TV Guide.
  3. Enable Show in sidebar and open TV Programme.

On first start, loading programme data can take a few minutes. Availability depends on publicly accessible sources.

Fits into your home

Use the overview on your phone, tablet or a large screen. Light and dark appearance can follow Home Assistant. The header remains accessible while scrolling.

A TV Guide card is also available for your dashboard. Your channel lists and saved programmes remain intact across restarts and updates.

Set up dashboard card ↗

Automate with TV Guide

TV Guide can provide five optional sensors in Home Assistant. Use them to react to the next reminder, saved programmes or EPG refresh status and build your own automations.

  • sensor.tv_guide_next_reminder – next scheduled reminder
  • sensor.tv_guide_bookmark_count – number of saved programmes that have not ended
  • sensor.tv_guide_reminder_count – number of outstanding reminders
  • sensor.tv_guide_last_update – time of the last successful EPG update
  • binary_sensor.tv_guide_refresh_running – shows whether EPG data is currently being refreshed

Sensors are disabled by default and can be enabled individually under Settings → Advanced → Available sensors.

Manuals

Dansk · Deutsch · English · Español · Nederlands · Français · Italiano · Norsk · Svenska