Xtream Codes: The IPTV Login Format Explained
Xtream Codes is the format most IPTV apps expect, and the one that gives you the tidiest result: organised categories, a populated guide and a separate on-demand library.
It is also where most setup failures happen, and almost always for the same small reason.
What Xtream Codes actually is
It is an API rather than a file. Your player asks the server several separate questions — what channels exist, what is on them, what is in the on-demand catalogue — and the server answers each one individually.
That separation is the whole advantage. Because the channel list, the guide and the VOD library arrive as distinct structured responses, the app can organise them properly instead of receiving one undifferentiated list.
The three things you enter
| Field | Looks like | Common mistake |
|---|---|---|
| Server URL | http://example.com:8080 |
Leaving off the port or the protocol |
| Username | Letters and numbers | Autocapitalised first letter |
| Password | Letters and numbers | Trailing space when pasted |
Why the port number matters
This causes more failed logins than everything else combined.
A server address usually needs a port on the end, something like :8080. Without it, your player connects to the wrong service on the same server and receives no authorisation — and the app reports a generic failure that looks identical to a wrong password.
So people retype a password that was correct all along. If a login fails and you are confident of the credentials, check the port before touching anything else.
Also check
- The address starts with
http://orhttps://— neither is optional - There is no trailing slash
- You have not appended
/cor/player_api.php, which belong to other contexts
What the API supplies that M3U does not
| Xtream Codes | M3U | |
|---|---|---|
| Channel categories | Grouped properly | One flat list |
| TV guide | Several days | Basic or none |
| Movies section | Separate | Usually absent |
| Series with seasons | Yes | No |
| Catch-up | Yes | No |
If your app shows channels but no guide and no Movies section, you are almost certainly on M3U. See formats explained.
Apps that support it
Nearly all of them: IPTV Smarters Pro, TiviMate, and most players on Android, Fire OS, iOS and desktop. The main exceptions are VLC, which only accepts M3U, and device-key apps on Samsung and LG televisions, whose dashboards expect an M3U link.
Common Xtream Codes errors
| Error | Real cause | Fix |
|---|---|---|
| Login failed / invalid credentials | Missing port, or a typo | Add the port; paste rather than type |
| Logs in, channel list empty | Hidden categories or partial download | Unhide categories; re-add the playlist |
| Channels play, guide blank | Guide still downloading | Wait three minutes on first setup |
| Guide times shifted | Device clock or time zone | Fix the device, not the app |
| Works on mobile data, not Wi-Fi | ISP blocking the port | Try a VPN or change DNS |
| Second device refused | Stream limit reached | Close the app fully elsewhere |
Xtream Codes questions
What is Xtream Codes?
It is an API used by most IPTV apps, where you enter a server URL, a username and a password. The server then supplies channels, guide data and on-demand content as separate structured responses, which is why categories and the TV guide come out organised.
Why does my Xtream Codes login keep failing?
Most often the server URL is missing its port number, such as :8080. Without it the app reaches the wrong service and reports a generic failure that looks exactly like a wrong password. Check the port, include http:// or https://, and paste rather than type.
What is the difference between Xtream Codes and M3U?
Xtream Codes supplies channels, guide and VOD as separate structured responses, so the app can organise them. An M3U link is one long URL containing a flat channel list, usually with little guide data and no on-demand section.
Which apps support Xtream Codes?
Nearly all of them, including IPTV Smarters Pro and TiviMate, on Android, Fire OS, iOS and desktop. VLC does not — it only accepts M3U — and device-key apps on Samsung and LG televisions generally expect an M3U link.
I logged in but the channel list is empty. Why?
If the login succeeded, the connection is fine. Check for hidden categories or a parental lock in the app settings, then refresh or re-add the playlist in case the list downloaded while the connection dropped.
Do I need both the port and http:// in the server URL?
Yes, both. The protocol and the port are part of the address, and omitting either produces an authorisation failure identical to wrong credentials.
Can I use Xtream Codes on more than one device?
Yes. Enter the same details on as many devices as you like. Only one can play at a time on a standard plan, and switching between them is instant.
My guide is empty with Xtream Codes. Is that normal?
On first setup, yes, for two to three minutes while the guide downloads. If it stays empty afterwards, or the times are wrong, check the device clock and time zone before adjusting anything in the app.