When you set up IPTV for the first time, you meet a handful of unfamiliar terms: M3U, playlist URL, Xtream Codes, EPG, XMLTV. They sound technical, but the ideas behind them are simple. This beginner’s guide explains each one in plain English, so you know what you are typing into your player and why. If you are new to IPTV altogether, start with what IPTV is and how it works.
First, what does a player app actually do?
An IPTV player is an app that plays streams. On its own, it has no channels at all. You give it a list of channels from your provider, and it shows that list in a friendly way and plays whichever stream you choose. The list is delivered in one of two common ways: an M3U playlist or an Xtream Codes login.
What is an M3U playlist?
An M3U playlist is a plain text file that lists streams, one after another. Each entry has a line describing the channel and a line with the stream’s address. A very simplified example, with made-up names, looks like this:
#EXTM3U
#EXTINF:-1 tvg-id="news.one" group-title="News",News One
http://example-server.tv/live/username/password/1001.ts
#EXTINF:-1 tvg-id="sport.one" group-title="Sport",Sport One
http://example-server.tv/live/username/password/1002.ts- #EXTM3U at the top tells the player this is a playlist.
- #EXTINF lines describe each channel: its name, its group (the category it appears under) and an ID used to match the TV guide.
- The line below each one is the address of the stream itself.
Your provider doesn’t send you the file itself. Instead you get an M3U URL: a web address that the player downloads the playlist from. Because the list is fetched from that address every time, any changes your provider makes appear automatically.
What is an Xtream Codes login?
Xtream Codes API is a different way of delivering the same information. Instead of one long playlist link, you get three pieces:
- a server URL, such as a web address with a port number;
- a username;
- a password.
The player logs in with these and asks the server for the live channels, movies, series and TV guide separately. Most modern players support it, and many people find it easier because the player can organise movies and series into proper libraries with posters and descriptions.
M3U or Xtream Codes: which should I use?
If your player supports both, Xtream Codes is usually the better choice:
- It loads movies and series as separate sections rather than one enormous list.
- The TV guide is usually included automatically.
- Typing a short username and password is easier than a long URL.
M3U is still useful for players that only support playlists, and for simple players like VLC that are handy for testing. Your IPTV UAE login details tell you which format to use for your device.
M3U and Xtream Codes at a glance
- What you type: one long playlist link for M3U; a server URL, username and password for Xtream Codes.
- Movies and series: often mixed into one long list with M3U; separate libraries with Xtream Codes.
- TV guide: sometimes a separate EPG link with M3U; usually automatic with Xtream Codes.
- Player support: almost universal for M3U; most modern players for Xtream Codes.
How the player organises your channels
Once the playlist is loaded, the player sorts channels into groups, using the group-title in each entry. Those groups become the categories you scroll through, such as News, Sport, Kids or Arabic. With a large line-up, a few habits make the list much easier to live with:
- Favourites: mark the channels you watch most. Most players show favourites as their own group at the top.
- Hide groups: many players let you hide whole categories you never watch, so the list stays short.
- Search: typing part of a channel’s name is often quicker than scrolling.
- Sort order: some players let you sort channels by number, by name or in the provider’s order.
Keeping your playlist up to date
Providers add, move and rename channels from time to time. With Xtream Codes and with an M3U URL, the player can download the latest version for you. Look for a setting called something like Update playlist on start, or refresh it manually now and then. If a channel suddenly stops working while others play, refreshing the playlist is the first thing to try.
What is the EPG?
EPG stands for electronic programme guide: the TV guide grid that shows what is on now and next on each channel. In IPTV, the guide data usually comes in a format called XMLTV, a file that lists programmes with their channel, start time, end time and description.
The player matches each programme to a channel using the ID from the playlist (the tvg-id in the example above). When the IDs match, the guide appears next to the channel. When they don’t, the channel shows “No information”.
With an Xtream Codes login, the player usually fetches the guide automatically. With M3U, you may need to add a separate EPG URL in the player’s settings, if your provider gives you one.
Common EPG problems and fixes
The guide is empty
- Give it time: the first download of guide data can take a few minutes.
- Use the player’s option to refresh or update the EPG.
- With M3U, check that the EPG URL has been added in the settings.
The guide is an hour or more out
- Check the time zone on your device. The UAE uses Gulf Standard Time (UTC+4) all year round, with no daylight saving.
- Many players have an EPG time offset or time shift setting. Adjust it until the guide matches what is actually on.
Some channels have a guide and others don’t
That is normal. Guide data isn’t available for every channel, and smaller channels in particular may not have listings.
Keep your playlist link private
Your M3U URL and Xtream Codes details contain your username and password. Anyone who has them can use your subscription. Don’t post screenshots of your player settings online, and don’t share the link outside your household.
M3U playlists and EPG: a quick glossary
- M3U: a playlist format listing channels and their stream addresses.
- M3U URL: the web address a player downloads your playlist from.
- Xtream Codes API: a login method using a server URL, username and password.
- EPG: the electronic programme guide, or TV guide grid.
- XMLTV: the file format most IPTV guides use.
- tvg-id: the ID that links a channel in the playlist to its guide listings.
- VOD: video on demand, the movies and series you start whenever you like.
Frequently asked questions
Is an M3U playlist the same as an IPTV subscription?
No. The playlist is just the list of channels your subscription gives you access to. The subscription is what makes the streams in the list work.
Can I open an M3U link in VLC?
Yes. VLC can open M3U playlists, which is handy for a quick test, but it doesn’t show a proper TV guide.
Why does my TV guide show the wrong time?
Check that your device is set to UAE time (UTC+4) and adjust the player’s EPG time offset if needed.
Where do I find my EPG URL?
With an Xtream Codes login, most players load the guide automatically. If you use M3U and need a separate guide link, ask us on WhatsApp.
Can I add the same playlist to several devices?
Ask your provider what your subscription covers before adding the same login to extra devices, so nothing stops working unexpectedly.