Skip to content

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 (.ts or .m3u8 stream).
  • 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:

  1. Server URL, for example http://line.provider.com
  2. Username
  3. 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

FeatureM3U playlistXtream Codes API
LoginOne long URLServer URL, username, and password
DataA plain text channel listSeparate database queries
EPGA separate XMLTV URL is neededLoaded through the API
UpdatesA manual playlist refresh is neededCurrent data is queried on demand
Best forBasic players, custom lists, and some Enigma2 boxesMost 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 .m3u files 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.

Contact support