Xtream Codes IPTV is a server API that lets apps pull live TV channels, movies, and series from an IPTV provider using three credentials: a server URL, a username, and a password. If your provider gave you those three pieces of information instead of an M3U link, you are using the Xtream Codes IPTV system.
How Xtream Codes IPTV actually works
The Xtream Codes API is essentially a web interface sitting on the provider’s server. When you open an app like TiviMate and type in your server URL, username, and password, the app sends a request to that server and gets back a structured list of channels, VOD titles, and series in JSON format. The app then uses that data to build the channel list you see on screen.
This is different from M3U, which is just a plain text file containing stream URLs. With Xtream, the app can query the server for specific categories, check whether your subscription is still active, and request individual stream URLs on demand. That’s why Xtream-connected apps handle channel logos, EPG (electronic programme guide) data, and catch-up TV more reliably than a static M3U file ever could.
The three credentials explained
- Server URL: The base address of the IPTV provider’s server, for example
http://streams.example.com:8080. It always includes the port number. - Username: Your account identifier on that server.
- Password: Your account password on that server.
Don’t share these with anyone. They’re tied to your subscription and, depending on the provider’s connection limits, sharing them can get your account suspended.
Connecting an app using Xtream Codes IPTV credentials
The steps below cover the most common apps. Option names vary slightly across them, but the process is the same.
TiviMate
- Open TiviMate and go to Settings, then Playlists.
- Tap the plus icon and select “Xtream Codes”.
- Enter your server URL (including the port), username, and password.
- Tap “Next” and let TiviMate load the channel list.
IPTV Smarters Pro
- Tap “Add User” on the home screen.
- Select “Xtream Codes API”.
- Fill in the server URL, username, and password fields.
- Tap “Add User” to confirm.
GSE Smart IPTV
- Go to Remote Playlists.
- Tap the plus icon and choose “Xtream Code”.
- Enter a name, the server URL, your username, and password.
If you have an M3U link and need to pull the Xtream credentials out of it, the M3U to Xtream converter on this site does that automatically. Paste the M3U URL and it extracts the server, username, and password so you can drop them straight into any of the apps above.
Common Xtream Codes IPTV errors and how to fix them
Below are the errors readers report most often, along with what actually causes them.
| Error or symptom | Likely cause | Fix |
|---|---|---|
| ”User not found” or “Wrong credentials” | Typo in username, password, or URL | Copy-paste the credentials rather than typing them manually |
| ”Connection timed out” | Wrong port or server is down | Confirm the port number with your provider; try again in a few minutes |
| Channels load but streams won’t play | Connection limit reached on your account | Check whether another device is already logged in; contact your provider |
| EPG missing or blank | App hasn’t finished loading the guide | Wait 5-10 minutes after first connection; restart the app |
| Stream buffers constantly | Slow line or overloaded server | Run the buffering test to isolate where the problem is |
| Some channels missing | Account package doesn’t include them | Check your subscription tier with the provider |
Before contacting your provider, use the IPTV stream checker to confirm whether the stream URL itself is reachable. If the checker shows the stream is live and playing, the problem is in your app or device, not the server.
Testing a stream before you pay
Providers often offer a short trial. Before committing, it’s worth checking a few things rather than taking stream quality on faith.
Check stream stability: Copy one of the channel URLs from your M3U, or ask the provider for a test stream, and run it through the IPTV channel viewer. You can see whether the stream loads cleanly and holds up over a short period.
Check connection speed: HD streams over Xtream Codes typically need at least 10 Mbps of stable throughput, and 4K needs considerably more. Use the IPTV speed test to see what your line is actually delivering to a stream endpoint, not just the headline number your ISP advertises.
Check credentials format: Some providers send credentials inside a full M3U URL rather than splitting out the three fields separately. The M3U to Xtream converter handles that. Paste the URL and it returns the three fields you need.
If anything looks wrong during the trial, raise it with the provider before paying. A provider that won’t let you test properly, or ignores problems during a trial period, isn’t worth subscribing to.
Xtream Codes vs M3U: Which should you use?
Both formats deliver the same underlying streams. The difference is in how your app manages them.
| Factor | Xtream Codes | M3U |
|---|---|---|
| Channel list updates | Automatic, app fetches fresh list on launch | Manual, you reload the M3U file or set a refresh interval |
| EPG support | Built into the API, most apps handle it automatically | Requires a separate EPG URL to be entered manually |
| Catch-up TV | Supported natively by the API | Only supported if the M3U file includes the right tags |
| App compatibility | Requires an Xtream-aware app | Works in nearly any media player that reads playlists |
| Troubleshooting | Easier to diagnose since errors come with status codes | Harder to diagnose since the file is static |
For most users, Xtream Codes produces a smoother experience because the app stays in sync with the server automatically. M3U is the better choice when you want to load a playlist into a generic player like VLC, or when the provider only offers a playlist file and nothing more.
If you have an M3U link and want to switch to Xtream, use the M3U to Xtream converter to extract the credentials. Not every M3U link contains embedded Xtream credentials, but links from providers running an Xtream server usually do.
Frequently asked questions
What is Xtream Codes IPTV? Xtream Codes is an API standard that IPTV providers use to deliver live channels, VOD, and series to apps like TiviMate and IPTV Smarters. You connect by entering a server URL, username, and password rather than loading an M3U file.
Is Xtream Codes safe to use? The API format itself is just a protocol. Safety depends entirely on the provider you subscribe to. Always verify the service is licensed to carry the channels it offers, and never enter your credentials into an app you do not trust.
Can I convert an M3U playlist to Xtream Codes format? Yes. Use the free M3U to Xtream converter. It extracts the server URL, username, and password from a compatible M3U link so you can paste them directly into an Xtream-compatible app.
Why does my Xtream Codes IPTV stream keep buffering? The most common causes are a slow connection, server overload on the provider side, or a congested home network. Run the buffering test to see whether the bottleneck is your line or the stream itself.
What apps support Xtream Codes login? TiviMate, IPTV Smarters Pro, GSE Smart IPTV, Smarters Player Lite, OTT Navigator, and Perfect Player all support Xtream Codes login. Most have an “Add playlist via Xtream Codes” or “Xtream API” option in their playlist settings.