ChannelSplice

M3U playlists and XMLTV guides, explained

Most live TV services and tuners describe their channels with two files: an M3U playlist (the channels) and an XMLTV guide, often called the EPG (what's on). Here's what's in each, how ChannelSplice uses them, and how to fix the usual problems.

What an M3U playlist is

An M3U playlist is a plain text file, usually ending in .m3u or .m3u8, that lists channels. Each channel has a line describing it and a line with the address of its stream:

#EXTM3U url-tvg="https://example.com/guide.xml.gz"
#EXTINF:-1 tvg-id="harbor.news" tvg-logo="https://example.com/harbor.png" group-title="News",Harbor News
https://example.com/live/harbor-news.m3u8
#EXTINF:-1 tvg-id="summit.sports" tvg-chno="12" group-title="Sports",Summit Sports
https://example.com/live/summit-sports.m3u8

ChannelSplice reads these parts of each channel:

What an XMLTV guide (EPG) is

The guide is a separate file in the XMLTV format, ending in .xml or .xml.gz (compressed; both work). It lists channels by id, and every program with its start and end, title, description, and often its episode, rating and a picture. ChannelSplice turns it into the TV guide on your screens: now and next, the timeline, reminders, search across what's on, and the Sports page.

Where the guide comes from:

Add them to ChannelSplice

  1. On your account page, choose Playlists I add here, then Add a playlist, Playlist link (M3U).
  2. Paste the playlist address, and the guide address if you have one.
  3. Tick the screens it's for. Test on the playlist tries both addresses from your browser, straight to your provider.

Your addresses are encrypted in your browser with your passphrase before they're saved, so ChannelSplice can't read them. Each screen downloads the playlist and guide itself, keeps them, and only downloads them again when they've changed. Step by step for a TV: Fire TV and Android TV.

Why the guide is empty, and how to fix it

ChannelSplice Server, a free program for a computer at home, goes further for people with several playlists or guides: it merges playlists into one lineup, matches channels to the right guide data, gives a channel with an empty guide the programs of the same channel from another of your guides, and warns when a guide is about to run out.

Playlist link or provider login?

If your service gives you a server address, username and password, use Provider login: it brings the guide and the provider's movies and series with posters and details, and shows when your subscription ends. A playlist link is for everything else, including lists you keep yourself. Both can be in one guide with ChannelSplice Pro.

Questions, ideas or something out of date? Ask on the ChannelSplice Discord or r/ChannelSplice on Reddit, or write to support@channelsplice.com.