What's On TV — EPG
Home Assistant Lovelace Card

A Lovelace card that displays your EPG channels in a configurable grid — current programme, progress bar, next programme, and a full schedule modal. Works alongside the What's On TV Integration.

Requires: What's On TV Integration

Pair with: What's On TV — Search & Notify Card for keyword alerts and automatic notifications

---

Features

• Configurable grid — 2 to 6 columns, adapts to any dashboard layout
• Auto-discovery — detects all whatson_tv sensors automatically, no manual setup needed
• Per-channel display — channel logo (with initial fallback), current programme title, start/end times and live progress bar
• Next programme — shows the upcoming title and start time below the progress bar
• Full schedule modal — tap any channel to open a scrollable programme list, with the current programme highlighted and auto-scrolled into view
• Drag & drop editor — reorder channels visually in the card editor, remove individually
• Dark and light themes with 8 accent colour presets + full custom HEX/RGB support
• Anti-flicker — only re-renders when programme data actually changes; progress bars update independently
• 49 languages — UI language follows your Home Assistant language setting automatically

---

Installation

Via HACS (recommended)

1. Open HACS → Frontend → ⋮ → Custom repositories
2. Add https://github.com/janfajessen/whatsontv-epg-card — category Dashboard
3. Search for What's On TV EPG Card and install
4. Refresh your browser

Manual

1. Copy whatsontv-epg-card.js to config/www/
2. In Home Assistant go to Settings → Dashboards → ⋮ → Resources → + Add Resource
3. Set URL to /local/whatsontv-epg-card.js and type to JavaScript module

Tip: Add ?v=1.1.0 to the URL to force browsers to reload after updates — e.g. /local/whatsontv-epg-card.js?v=1.1.0

---

Usage

Minimal — auto-discovers all channels

type: custom:whatsontv-epg-card

Full configuration

type: custom:whatsontv-epg-card
title: TV Guide
theme: dark
accent: "#e8872a"
columns: 3
entities:
  - sensor.epg_la_1
  - sensor.epg_antena_3
  - sensor.epg_bbc_one
  - sensor.epg_rtve_24h

If entities is omitted, the card discovers all sensors provided by the What's On TV integration automatically.

---

Visual Editor

The card includes a full visual editor accessible from the Lovelace dashboard edit mode:

• Theme — toggle between dark and light with a single click
• Accent colour — choose from 8 presets or enter any HEX or RGB value
• Title — customise the card header text
• Columns — set between 2 and 6 columns
• Channels — drag ⠿ to reorder, click ✕ to remove individual channels

---

Configuration Options

Option	Type	Default	Description
title	string	(none)	Card header title. Leave empty to hide the header
theme	dark / light	dark	Visual theme
accent	string	#e8872a	Accent colour — HEX (#fa1a00) or RGB (200,100,0)
columns	number	3	Number of columns in the grid (2–6)
entities	list	(auto)	List of EPG sensor entity IDs. If omitted, all sensors are auto-discovered

---

📋 Requirements

• Home Assistant 2024.1+
• What's On TV EPG TV Guide integration installed

---

🤝 Related cards

• What's On Series & Films Card — Full Platforms, Cinema guide.
• What's On TV Search & Notify Card — Search & notifications

---

If this integration is useful to you, consider giving it a ⭐ on GitHub. Or consider supporting development!

License

MIT — see LICENSE

© @janfajessen