M3U vs Xtream Codes

M3U and Xtream Codes are two ways a provider can hand you an IPTV playlist. An M3U playlist is a file reached through a link. Xtream Codes is an API: you give a player a server address, a username and a password, and it asks the server for the lists it needs.

SmartMate is a media player. It does not provide or sell any content, so both methods rely on a provider you choose and have the right to use.

At a glance

	M3U link	Xtream Codes login
What you receive	One web address	Server address, username, password
What the player gets	A single text file with everything	Separate lists requested from the server
Typical structure	Flat list grouped by group-title	Live TV, movies and series are separate sections with their own categories
Program guide (EPG)	Often a separate guide link, or tvg-id matching	Served by the same server as XMLTV data
Updates	Download the file again	Player asks the server again
Credentials	May be hidden inside the link	Entered as separate fields

How M3U works

You get a link such as https://example.com/playlist.m3u. The player downloads the file and reads every entry. Everything, including live channels, movies and episodes, is in that one file and is sorted into categories using group-title. See What is an M3U playlist for the format.

Good to know: because everything arrives in one file, a very large playlist means a very large download. If the link has your credentials inside it, keep it private.

How Xtream Codes works

Xtream Codes is the name of an IPTV panel software, and its API became a common standard that many providers copy. You enter three things:

• Server address, including http:// or https:// and usually a port, for example http://example.com:8080
• Username
• Password

The player then calls the server's API (commonly the player_api.php endpoint) and asks for live categories and streams, movies, and series separately. The same server usually provides guide data in XMLTV format.

Good to know: because lists are fetched in parts, a player can show details for movies and series, such as artwork, descriptions and episode lists, when the server supplies them. What you see still depends on what your provider sends.

Which one do I have?

• If you were given one long web address, often ending in .m3u or .m3u8 or containing type=m3u, you have an M3U link.
• If you were given a server address, a username and a password, you have Xtream Codes details.
• Some providers give you both. Either works. Choose the one your provider recommends for your player.

Which should I choose?

There is no universal winner. A rough guide:

• Choose Xtream Codes when it is offered and you want sections for live TV, movies and series that are fetched separately.
• Choose M3U when your provider only gives a link, or when you maintain your own playlist file.

If one method misbehaves, trying the other one from the same provider is a reasonable troubleshooting step.

Common mistakes

• Leaving out http:// or https:// in the server address.
• Forgetting the port number when the provider includes one.
• Mixing up the username and password, or adding a space when copying.
• Using an expired link or an account that is no longer active. Only your provider can fix that.

Next steps

Ready to load your playlist? Follow How to add a playlist in SmartMate.