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:
- The name after the comma (or
tvg-name). group-title: the group it's listed under. You choose which groups each screen shows.tvg-id: the channel's id in the guide. This is what links a channel to its programs.tvg-logo: its logo, andtvg-chno: its channel number (sub-channels like 5.1 keep theirs).- Catch-up details, where the provider keeps the last few days of a channel (
catchup,catchup-source,catchup-days): you can then go back in the guide and watch a program from the start.
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:
- A provider login brings its own guide. Nothing to add.
- A playlist link: add the guide's address beside it on your account page. Leave it blank and ChannelSplice uses the guide the playlist names in its first line (
url-tvgorx-tvg-url), if it does. - An HDHomeRun tuner uses SiliconDust's free guide.
Add them to ChannelSplice
- On your account page, choose Playlists I add here, then Add a playlist, Playlist link (M3U).
- Paste the playlist address, and the guide address if you have one.
- 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
- No guide address. The playlist doesn't name a guide and none was added: add the guide's address on the playlist.
- The ids don't match. Channels find their programs by
tvg-id. A channel with no id, or an id the guide doesn't use, gets no programs. ChannelSplice also tries the channel's name against the guide's names, which fills in many, but not every one. - The guide has run out. "The guide has run out: its source hasn't been updated" means the file has no programs from now on. The provider needs to update it.
- A big guide. Large guides take a little longer the first time. After that they're kept on the screen.
- A provider that asks for a particular player may refuse the guide too: set its User-Agent on the playlist (Only if your provider asks).
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.