Add a programme guide (XMLTV EPG)
Updated 8 November 2026
The programme guide (or EPG) shows what is on now and next on each channel. iAm Player reads guides written in XMLTV.
Most of the time, it is already there
- Xtream Codes account: your provider's guide is added by itself when you add the account.
- M3U playlist: if the playlist's first line (#EXTM3U) names a guide with the x-tvg-url attribute, that guide is added by itself. If your playlist gives its guide another way, add it yourself, as below.
These guides show in “Guide sources” marked “Auto”: they follow their source, and you change them from it.
Add a guide yourself
- Open “Settings”, then “TV Guide” and “Guide sources”.
- Press “Add”.
- Enter a “Name”, then paste the guide's “URL”. The “User-Agent” field is optional: leave it empty unless your provider asks for one.
- Press “Save”.
You can add several guides. Each has a switch to turn it on or off, and a priority you change with the arrows.
Accepted formats
- XML (.xml)
- Gzip-compressed XML (.xml.gz)
- Zip archive (.zip)
The .xz format is not accepted: ask your provider for a .xml, .xml.gz or .zip link.
How each channel finds its programmes
- By its EPG id: the tvg-id of an M3U playlist, or the EPG id an Xtream Codes account gives. It must be identical to the channel's id in the guide.
- A channel without an EPG id takes the programmes of the guide channel with exactly the same name (ignoring case, accents and quality tags such as HD). This only applies to guides you added yourself, and not to a channel filed under another country than the guide's.
Programmes an hour off?
If all of a source's programmes are early or late, open “Settings”, “Sources and catalog”, then “Manage sources”. Choose the source, then “Guide offset”. Pick the offset (from −6 h to +6 h, in quarter hours), then press “Apply”. “0 min” removes it.
Open the guide
- On a phone: in Live TV, tap “TV Guide”.
- On a TV: “TV Guide” at the top of the categories column, or the remote's INFO or MENU button.
The guide stays empty? “Settings”, “TV Guide”, then “Refresh the guide” reloads it. You can also ask the community on Discord.