TV Guide for Home Assistant

Poland is available: 50 main channels, additional channels from the programme feeds and a Polish interface.

Spain is available: 48 national and regional main channels, plus additional channels from the programme feeds.

Italy is now available: 45 prepared main channels and additional available channels from the programme feeds.

See what is on TV now, plan your evening, save programmes and get reminders. TV Guide works on desktop and mobile, with light and dark themes that can follow Home Assistant.

Deutsch · English · Français · Italiano · Nederlands · Norsk

What you can do

• Choose Germany, Italy, Austria, Switzerland, the Netherlands, Belgium, Denmark, Norway, France, Sweden or the United Kingdom. Each country has prepared main channels and additional channels when schedule data is available.
• Open Now, 18:00, 20:15, 22:00, or choose another day and time.
• Create My channels with your own selection and order. Combine channels from all supported countries in one personal list. Your selection stays when you change country.
• Open a programme for details, save it and set a reminder 5, 10, 15 or 30 minutes before it starts.
• Use Danish, German, English, Dutch, French, Italian, Norwegian or Swedish. The automatic setting follows your Home Assistant profile.

France includes 24 national main channels; BFMTV is temporarily excluded.

Install with HACS

Requires HACS and Home Assistant 2026.10.1 or newer.

1. Until approval in the HACS catalogue: open HACS → ⋮ → Custom repositories. Enter https://github.com/criticallimit/HA-TV-Guide, select category Integration and choose Add.
2. Search HACS for TV Guide and download the latest published release. Restart Home Assistant. For a new installation, add TV Guide under Settings → Devices & services → Add integration.

Already installed? Keep your existing TV Guide integration entry. HACS then manages updates; install them through HACS and restart Home Assistant afterwards.

Open in HACS

Ready to use

After adding the integration, TV Guide appears automatically in the Home Assistant sidebar. Open it to use the complete programme guide. Country and language come from Home Assistant; programme data and the logo library load automatically. The first opening shows progress while preparation is running.

Using the guide requires no dashboard card, YAML configuration or resource setup. For an additional view in your own dashboard, the optional TV Guide card is available in Home Assistant’s visual card picker.

Country and language

Open the settings button and select Country & language. Select the country whose TV schedules you want to see. Switzerland includes channels from its three language regions; Belgium includes Dutch- and French-language channels.

Automatic · Home Assistant uses your Home Assistant profile language first, then your installation settings. If no language is available, Denmark uses Danish, Germany and Austria use German, the Netherlands uses Dutch, Norway uses Norwegian, France uses French, Sweden uses Swedish, Italy uses Italian and the United Kingdom uses English. For multilingual countries, the browser language is used; English is the fallback. You can also choose a language manually.

Country and language are independent: Swiss schedules can be displayed with a French or English interface. Programme titles and descriptions stay in the source language. A reminder keeps the language used when you created it.

Personalize the guide

Main channels shows the prepared list for your TV country. Open ☰ Channels, tick the countries you want to browse and search for a channel. Add channels to My channels and drag them or use the arrows to set their order. Unticking a country only hides its available channels; it keeps your selected channels. Remove a channel with ×, then save. Reset order restores the main channels of the currently selected TV country. Your previous selection is carried over when you first save the new list.

Settings are grouped into Country & language, Display and Reminders. Set the default view, appearance and channels per row under Display. A channel limit of 0 shows the entire selected list. Open Advanced to change the schedule refresh interval. Press Save to apply your changes.

Save programmes and get reminders

Open a programme and select Save. Find saved programmes under ★ Saved. For a saved future programme, enable Remind me and choose how early to be notified.

In settings, open Reminders and choose Home Assistant or a connected mobile device. Use Test notification to check the destination. TV Guide and Home Assistant must be running when the reminder is due.

Your saved programmes and channel lists are available on devices using the same Home Assistant installation and survive restarts and updates.

When something is missing

No programme for a channel: Availability depends on public sources. Confirmed broadcaster data is preferred; other feeds fill gaps. Coverage and updates vary by channel and date. The Netherlands currently uses a checked public programme feed.

Empty guide after an update or country change: Let the download finish and reopen the guide after a few minutes.

No reminder: Check the destination in settings and send a test notification. Mobile reminders need a device connected to the Home Assistant app.

Updates and help

Report an issue and include the country, channel, date and time.