TV guide (EPG)
An IPTV TV guide you will actually use
An electronic programme guide, the EPG, is what turns a list of channels into television. Aina reads your provider’s XMLTV guide and puts it everywhere it helps: under each channel, across your whole line, and in the player.
Updated · By the Aina IPTV team

Everywhere you look
- On Live TV: what is on now and what is next under every channel, with a bar showing how far through it is.
- In the guide: what is on now and what starts in the rest of the hour, then each hour of tonight and the days after. Chips choose when it starts and which categories it covers, and a search finds any programme by its title.
- On each channel: its schedule, opened on what is on air, a week ahead on a phone or tablet and the day ahead on a television, which keeps less to leave room on the box.
- On Home: what is on now, a tap from playing.
Catch-up
Where your provider keeps an archive, programmes that have already aired are marked in the schedule and play from their start: through the archive of an Xtream Codes line, or the catch-up attributes of an M3U playlist. How many days back you can go is your provider’s choice.
Where the guide comes from
- An Xtream Codes login brings its guide with it: Aina fetches it from the panel, and there is nothing to set up.
- An M3U playlist often names its guide in its first line, and Aina finds it. If it does not, add the guide link your provider gave you when you add the playlist.
- A MAC portal brings the portal’s own guide, read by Aina as a set-top box reads it.
- Either kind of guide can be plain XMLTV (
.xml) or compressed (.xml.gz).
Your own guides, and times that fit
In Settings, then TV guide sources, each subscription’s guide is yours to set. Move the provider’s guide later or earlier, by whole hours or half hours, when every programme is out by the same amount; switch it off to use your own instead; or add XMLTV guides of your own by their address, each with its own time and switch. Added guides fill in the channels the provider’s leaves out. The corrected times reach every list, the schedule and catch-up.
Step by step, and why a guide can come up empty: How to add a TV guide (EPG).
Matched to the right channels
An XMLTV guide lists programmes by channel id, and a playlist names the id it uses for each channel. Aina matches the two, and where a channel has no id, or the guide does not use it, it matches by the channel’s name instead, so more of your line has a schedule.
Big guides, handled
A week of guide for a big provider can run to hundreds of megabytes, the largest download an IPTV app makes. Aina writes it to storage as it arrives and reads it back a piece at a time, so a guide that size does not exhaust the memory of a phone or a television box.
Sports and reminders
The Sports page gathers the matches and sports programmes on now and in the next day on your line’s sports channels, straight from the guide. Press a match that is on to play it, or one to come to be reminded: a notification five minutes before on a phone or tablet, and on a television the app goes to the channel as it starts.
On the big screen
On Apple TV and Android TV, the guide is laid out for the remote: move through the hours and the categories with the arrows, and press to play what is on or to open a channel’s schedule. Over the picture, a small guide shows what is on and next as the channel changes.
Questions and answers
The electronic programme guide: the schedule of what is on each channel. IPTV providers publish it as an XMLTV file, which a player reads and shows beside the channels.
Usually because the guide does not cover those channels, or its channel ids do not match the playlist’s. With an M3U playlist, check that you added a guide link. How to add a TV guide has the full list.
Only on the channels your provider archives, and only as many days back as it keeps them. Aina marks those programmes in the schedule.