M3U vs Xtream Codes: which IPTV connection to use
Compare M3U playlists and the Xtream Codes API, see how each loads channels and EPG data, and choose the better option.
Updated November 14, 2026 3 min read
On this page
When you set up an IPTV player such as TiviMate, IPTV Smarters Pro, or an Apple TV app, you usually choose between two connection methods: an M3U playlist URL or the Xtream Codes API.
Both methods deliver live TV, movies, and electronic program guides (EPG) to your device, but they process and structure data differently. The choice affects stream stability, channel organization, EPG loading times, and Video on Demand (VOD) features.
How M3U playlists work
An M3U (MP3 URL) is a plain text file, or a single long web URL, that contains a sequential list of streaming addresses and basic channel metadata.
When you paste an M3U link into an IPTV app, the app downloads the entire text file at once. The file contains media tags such as:
http://server.address/get.php?username=ABCD&password=EFGH&type=m3u_plus&output=t
- Data structure: the M3U file maps the channel name, category (
group-title), channel logo, and direct server link (.tsor.m3u8stream). - EPG integration: plain M3U playlists do not include TV guide data. To get channel schedules, you must find and paste an XMLTV EPG URL separately.
- Updates: the file is static after download. Any change your provider makes to channel numbers or stream addresses requires a full manual playlist refresh in your app.
How the Xtream Codes API works
The Xtream Codes API is a database protocol. It creates a direct, interactive connection between your IPTV player app and the provider's management server.
Instead of pasting a long text link, you enter three parameters:
- Server URL, for example
http://line.provider.com - Username
- Password
When you click log in, your IPTV player sends separate, lightweight database requests to the server:
- Live channels:
/player_api.php?username=...&password=...&action=get_live_streams - EPG guide:
/player_api.php?username=...&password=...&action=get_short_epg - VOD and series:
/player_api.php?username=...&password=...&action=get_vod_streams
Because the requests are split into separate database calls, the app loads channel lists, EPGs, and VOD movie posters independently in the background without freezing the interface.
Key differences
| Feature | M3U playlist | Xtream Codes API |
|---|---|---|
| Login | One long URL | Server URL, username, and password |
| Data | A plain text channel list | Separate database queries |
| EPG | A separate XMLTV URL is needed | Loaded through the API |
| Updates | A manual playlist refresh is needed | Current data is queried on demand |
| Best for | Basic players, custom lists, and some Enigma2 boxes | Most modern players |
Which one should you use
Use the Xtream Codes API
Always choose the Xtream Codes API when your provider supports it and your player allows it. It gives a better user experience, accurate TV guide data, organized movie and series posters, and native catch-up support.
If your provider sent only a single long M3U web link, you do not have to type the entire link into your TV. You can extract your login details by following how to find the server address in an M3U URL.
Use an M3U playlist only when
- Your player app supports only playlist links, such as basic web players or older Smart TV apps.
- You load customized, privately edited channel lists or custom
.m3ufiles created with playlist editors. - You use specialized hardware, such as certain Enigma2 boxes, that prefer direct M3U string imports.
Troubleshoot connection problems
- The app crashes on startup with an M3U playlist. If your provider offers a very large library (100,000+ live streams and movies), loading a raw M3U file can make low-RAM streaming sticks such as Fire TV Sticks run out of memory. Switch to the Xtream Codes API to query categories on demand.
- Streams freeze or buffer. With either method, stream stability depends on network routing. If buffering continues, see buffering in IPTV to adjust buffer sizes or fix ISP throttling.
More in IPTV Basics
Still stuck?
Our support team can help you set up your device or fix a problem.