📅 EPG

EPG - Electronic Program Guide

Overview

The EPG module generates DVB-compatible EIT (Event Information Table) sections and broadcasts them via UDP multicast. It supports import from XMLTV format and automatic updates from external sources.

Architecture

Components

Ingester

Imports EPG data from XMLTV files. Supports automatic refresh from URL sources.

XMLTV format parsing|Channel mapping to EPG services via XMLTV ID|Automatic refresh based on set interval

Builder

Generates EIT sections according to DVB standard (ETSI EN 300 468).

EIT p/f (present/following) - current and next program|EIT schedule - program for 8 days ahead|Descriptors: short_event (0x4D), extended_event (0x4E), content (0x54), parental_rating (0x55)|CRC32 validation

Carousel

Broadcasts EIT sections via UDP multicast in a loop.

MPEG-TS packetization (188 byte packets)|7 packets per UDP datagram (1316 bytes)|Configurable multicast IP, port, TTL|Auto-start on boot (optional)

Configuration

Carousel Settings

Parameter

Default

Description

Multicast IP address for EIT broadcast

UDP port

Time-to-live for multicast packets

Network interface for broadcast

Auto-start on server boot

EPG Service Settings

DVB Service ID (SID) - unique service identifier

DVB Transport Stream ID (TSID)

DVB Original Network ID (ONID)

Channel ID in XMLTV file for program mapping

ISO 639 language code (e.g., \"eng\", \"slk\", \"ces\")

Number of 3-hour segments in EIT schedule (max 64 = 8 days)

XMLTV Import

EPG data can be imported from XMLTV files. Both local files and URL addresses are supported.

XMLTV format example:

Import via UI:

Go to EPG → Sources

Use \"Quick Import from URL\" for one-time import

Or add an automatic source with refresh interval

DVB Technical Details

EIT Table IDs

Table ID

Type

Current and next program for current TS

P/F for other TS

Program for 8 days for current TS

Program for other TS

MPEG-TS Packetization

PID for EIT: 0x0012 (18)|TS packet size: 188 bytes|UDP datagram: 7 × 188 = 1316 bytes|Continuity counter: 4-bit cyclic counter

Useful Links

EPG Dashboard - Overview and controls

EPG Services - Service/channel management

EPG Sources - XMLTV sources

EPG Schedule - Program browser

EPG Settings - Carousel settings