Feature · Program guide

A TV guide that knows what is on

IPTVnator turns XMLTV files and portal schedules into a program guide: what is on now in every channel list, a timeline under the player, a grid across all channels, catch-up for archived programs, and manual mapping when a channel does not match.

  • XMLTV .xml & .xml.gz
  • Timeline or list
  • Catch-up
  • Manual channel mapping
Channel list with the current program and progress bar for every channel
Channel list with the current program and progress bar for every channel

What you get

The guide, everywhere

One schedule, shown wherever a channel appears.

01

Now and next in every list

Each channel row shows the current program with a progress bar, in the playlist views, the portal lists and the favorites and recent collections.

02

A timeline under the player

The schedule of the selected channel runs as a ribbon with day navigation, zoom levels, a jump to now, and a program search. A vertical single-day list is the alternative view.

03

A grid across channels

The multi-channel view lays the schedules of all channels side by side on one time axis, with channel filtering and program search.

04

Program details

Title, category, description, episode, language, rating and duration open in a dialog from any program block.

05

Catch-up

Where the provider keeps an archive, past programs start straight from the timeline, on M3U playlists with catch-up attributes and on Xtream and Stalker portals.

06

Manual channel mapping

A channel the guide cannot match gets a right-click action to pick its XMLTV entry by hand. Mappings are stored on your device and survive refreshes.


Sources

Where the guide comes from

M3U playlists
XMLTV sources from Settings › EPG or declared by the playlist through url-tvg. Channels match by tvg-id, then tvg-name, then name.
Xtream Codes
The portal schedule is used first; your XMLTV sources fill missing channels or take precedence with one setting.
Stalker portals
A seven-day schedule is loaded from the portal once per session; single-channel requests fill any gaps.
Formats
XMLTV as .xml or compressed .xml.gz, parsed in a background worker and stored in a local database.
Sources
Any number of global sources plus per-playlist sources, each with a status chip, a refresh button and one refresh-all action.
Availability
The XMLTV guide is a desktop feature. Portal schedules from Xtream and Stalker also show in the browser version.
Settings with the EPG section open, a source URL entered and its status chip

FAQ

Questions about the program guide

Where does the program guide come from?+

From XMLTV files you add or your playlist declares, and from the schedules Xtream and Stalker portals publish. IPTVnator merges them per channel: portal data first, your XMLTV sources as a fallback or, with one setting, as the preferred source.

Why does a channel show no program?+

It is not matched to a guide entry. Matching uses tvg-id, then tvg-name, then the channel name. Check the ids in the playlist, or map the channel by hand with a right-click and "Map EPG channel".

Can I watch a program that already aired?+

Yes, when the provider keeps an archive. M3U playlists declare it with catchup attributes, Xtream and Stalker portals flag archived channels. Past programs then start from the timeline; without an archive the timeline is a schedule only.

How big can the XMLTV file be?+

Large guides are fine. Parsing runs in a background worker and the result is stored in a local database, so the app stays responsive and the data is there on the next start.

Does the guide work in the browser version?+

Portal schedules from Xtream and Stalker sources do. XMLTV downloads and the local guide database are desktop features.

Can I see several channels at once?+

Yes. The multi-channel view lays all schedules on one time axis with zoom, channel filtering and program search, in addition to the timeline of the selected channel.


Keep reading

Guides and background

Official downloads only

IPTVnator is a player, not a TV service. It is distributed exclusively through GitHub releases and the package managers listed on this page. Websites that sell "IPTVnator subscriptions", channel packages or "activated" copies are not affiliated with the project. How to recognize unofficial sites.