Skip to content
Nipo Player

XMLTV guide

Nipo Player is an M3U player with a TV guide (EPG). XMLTV is a standard format for describing that programme guide: a list of channels, and for each, its programmes with start and stop times.

Player only

Nipo Player does not provide, sell or host any content. Use it with playlists you are legally allowed to access.

In one sentence

An XMLTV guide lists channels (<channel>) and their programmes (<programme>) with precise times; Nipo matches it to your playlist by channel id, and accepts a compressed file (.xml.gz).

The structure

Every channel has a unique id, and every programme references that id with its times. Example with fictional names:

guide.xml

<?xml version="1.0" encoding="UTF-8"?>
<tv>
  <channel id="aurora1.fictif">
    <display-name>Aurora 1 HD</display-name>
  </channel>
  <programme start="20260928190000 +0200" stop="20260928200000 +0200" channel="aurora1.fictif">
    <title>Grand quiz du soir</title>
    <desc>Émission fictive de divertissement.</desc>
  </programme>
</tv>

How Nipo matches the guide to your playlist

Matching happens by id, in this order:

tvg-id

Your M3U playlist’s tvg-id attribute (or the guide id an Xtream login provides) is compared to the id attribute of the guide’s <channel> tags.

tvg-name

If no tvg-id matches, Nipo falls back to the channel’s name (tvg-name) to try a match.

No match

If nothing matches, the channel still plays live normally, simply with no programme shown in the guide.

Your own XMLTV link

In Settings → Guide → “Guide source”, paste the link of a .xml or .xml.gz guide to use instead of the one your playlist provides. Leave the field empty to go back to the original guide.

FAQ

Does Nipo accept compressed guides (.gz)?

Yes. A .xml.gz link is decompressed automatically, even when the server doesn’t announce it correctly.

What happens if a channel has no programme in the guide?

It still plays normally; only the programme panel stays empty in the guide and the player’s mini guide.

Can I use an XMLTV guide in a different language than my playlist?

Yes, as long as the channel ids (tvg-id) or names match, the language of the titles doesn’t affect matching.

How many days does an XMLTV guide cover?

It entirely depends on the guide provided; some cover a week, others only the current day.

Add your XMLTV guide

From Settings → Guide, in seconds.

Download for freeSee the other formats