Skip to content
Content
EPG Setup

EPG Setup

An EPG turns a list of channels into a television service: programme names now and next, a guide grid, catch-up that knows where a show starts. XUI.live imports standard XMLTV guides, maps them to your channels, and serves the result to every player and device automatically.

Add a source

Open EPG’s → Add EPG. A source is four decisions:

  • Name — how it appears in the channel editor.
  • File — the XMLTV feed, as a URL or a file path.
  • Days to keep — how much guide history stays in the database. Keep it aligned with your TV archive window, so catch-up always has listings to stand on.
  • Offset — shift the whole source by whole hours when a provider publishes its guide in a different timezone than the feed actually airs in.

Add as many sources as you carry providers — each channel picks its guide independently, so mixing a national XMLTV with a sports-specific one is normal, not a workaround.

Refresh

Sources refresh automatically once a day at midnight; the schedule is a standard cron expression you can edit per job in the panel. Just added a source or fixed a feed? Force Reload on the EPG list re-imports on the spot. The list shows how many channels each source carries, so a feed that silently shrank is visible at a glance.

Map channels

The binding lives on the stream editor’s EPG tab: pick the source, then the channel inside it, then the language where the feed carries more than one — with a per-channel offset for the regional variants that air an hour apart. Set it once when you add the stream; the guide follows the channel everywhere after that.

The TV guide

TV Guide in the panel shows the imported data as a browsable grid — the fastest way to confirm a mapping is right before a subscriber ever sees it. What they see arrives through their apps: programme info in the player, get_short_epg and get_epg on the Xtream Codes API, and a full XMLTV export per line for apps that consume a guide file directly.

An accurate guide is also what makes the TV archive sell itself — a subscriber rewinds a programme, not a timestamp. If you carry catch-up channels, treat the EPG as part of the product, not decoration.