Xtream Codes: what it is, and how to connect your IPTV service
An Xtream connection, often called Xtream Codes, gives a player access to an IPTV service with three details: a server URL, a username and a password. Nani, an IPTV player for Web, Android and Android TV, connects this way.
This page is for anyone who received those three details without knowing what they are. It explains what an Xtream connection is, how to recognise yours, what sets it apart from an M3U playlist, and what Nani does with it. No technical background is needed.
The name comes from a management panel IPTV services used to administer their subscribers. It stuck: in many applications the connection option is still labelled “Xtream Codes API”.
- Also called Xtream Codes API
- URL + username + password
- Different from an M3U playlist
- Web · Android · Android TV
- Supported source
Your credentials open the service. Nani builds the experience.
Xtream carries your service data; Nani turns it into a clear interface shared across your screens and tailored to each profile.
- 01 · Connection
Your Xtream access
The server URL, username and password supplied by your service.
- 02 · Organisation
Nani puts it in order
Live TV, films, series and the guide are presented in one coherent navigation.
- 03 · Continuity
Your experience follows you
One account on Web, Android and Android TV, with separate profiles and progress.
What an Xtream connection is
Xtream is not a file you download but an interface your service’s server exposes. The player asks; the server answers.
An interface, not a file
Nothing is stored ahead of time. Each time you open it, the player asks the service what you are entitled to and shows only the answer.
Three details, never more
A server URL, a username, a password. That is all the player needs to ask its question.
The list stays current on its own
Because the player queries the service every time, a channel added or dropped shows up without you reloading anything.
Live, films and series kept apart
The connection usually exposes those three families separately, with the programme guide when the service supplies it. That is what lets a player file them instead of piling everything up.
A URL that often carries a port
It looks like a website address and frequently ends with a colon and a number. That number is part of the address.
A common practice, not a published standard
Xtream is very widespread among IPTV services, but no body publishes it as a standard, which is why services differ slightly.
Xtream Codes or M3U playlist: telling which one you have
Your service sent you one or the other when you signed up. The shape of the message almost always settles it.
Three separate fields: Xtream
A server URL, a username and a password listed one under the other. That is the most common shape.
A single link to paste: M3U
No username, no password, just one long address: that is an M3U or M3U8 playlist, the other family of connection.
What really separates them
An Xtream connection queries the service live; a playlist is a list the player rereads. That is why one updates itself and the other has to be reloaded when your service changes it.
Both at once
Some services provide both. Nani accepts either, so use the one your service recommends.
If a doubt remains
No shape proves the protocol for certain. Only your service can confirm what it gave you.
Nani in two lines
You landed here from a search about Xtream: here is the player this page keeps talking about.
An IPTV player
Nani is an application that reads the IPTV service you subscribed to and presents its channels, films and series.
On three platforms
The web in a browser, Android on phone and tablet, Android TV on the television. One account covers all three.
Your service stays yours
The subscription, the channels and the catalog are the ones you chose. Nani only reads them.
Availability
Nani opens its beta gradually. Joining the list is free and needs no card; full beta access costs a one-time €2.99 when the beta opens.
What Nani does with those credentials
Once connected, Nani does nothing more than read what your service exposes.
Nani asks, it stores no content
Channels, films and series stay with your service. Nani presents the list and starts playback.
What you see comes from the service
A channel that is not in your plan does not appear. Nani neither completes nor enriches any catalog.
The guide follows what the service supplies
Programmes are shown when the service makes them available, and only then.
Credentials stay with the account holder
One profile manages the connection. The other profiles in the household watch without access to it.
Why go through Nani
Plenty of players can read an Xtream connection. Here is what Nani does differently with it.
Entered once, three screens
You type your credentials once. Web, Android and Android TV share them and never ask again.
Nothing else to set up
The connection is Nani’s only technical setting. No list to sort, no options to discover before watching.
One service, without stepping on each other
Favorites, history and progress stay specific to each profile, even when the subscription is shared at home.
The three details, spelled out
Your service may call them something else. Here is what each one is and the shape it usually takes. The examples below are made up.
What you type in
- Server URL
- http://example-service.tld:8080
- Username
- user12345
- Password
- ••••••••••
| Detail | What it is | Usual shape |
|---|---|---|
| Server URL | The address your service answers on. Also called host, server, portal or API address. | http://example-service.tld:8080 |
| Username | Your identifier with that service. It is neither your email address nor your Nani account. | user12345 |
| Password | The key that goes with that username. It belongs to the service, not to Nani. | a1b2c3d4e5 |
Connecting your service, step by step
Four moves, three of which you can prepare before you even open Nani.
Find the message from your service
The three details were handed to you when you subscribed, usually by email. Nani does not supply them and cannot recover them for you.
Copy the URL in full
Keep the http:// or https:// at the start and the port number at the end if there is one. A truncated address no longer points at the right server.
Enter the three details once
The connection covers the whole Nani account: you do not repeat it on Web, on Android or on Android TV.
Let Nani query the service
Channels, films, series, guide, number of simultaneous screens: Nani reads what your service exposes and follows it.
Xtream-compatible does not mean provider.
Nani reads an IPTV service that uses Xtream; it provides, sells and hosts none. The subscription, the channels and the catalog remain those of the service you chose and signed up for yourself.
See all featuresFrequently asked questions about Xtream Codes
What is an Xtream connection?+
An interface exposed by an IPTV service’s server, which the player queries using a server URL, a username and a password. The service answers with the list of what you are entitled to.
Are Xtream and “Xtream Codes” the same thing?+
In everyday use, yes. The name comes from a management panel IPTV services used; today it names the connection method built on a URL and credentials, often shown as “Xtream Codes API” in applications.
Is Xtream Codes free?+
It is a connection method: it is not sold and costs nothing in itself. What you pay for is the IPTV subscription you took out, and possibly the player you use.
What is the difference between Xtream Codes and an M3U playlist?+
An Xtream connection queries the service every time you open it, using your credentials, and the list stays current on its own. An M3U playlist is a list the player rereads; it has to be reloaded when your service changes it.
How do I know whether my service uses Xtream?+
If it handed you a server URL, a username and a password separately, it probably does. A single link to paste looks more like an M3U or M3U8 playlist.
Does the number after the colon matter?+
Yes. It is the server port: it is part of the address and must be copied along with it.
Can I use the same connection on several devices?+
Yes. The connection covers the whole Nani account and comes back on Web, Android and Android TV without retyping it. How many streams you can watch at once depends on what your service allows.
Can I share my credentials?+
Better not to. Every open stream uses one of the simultaneous connections your service grants you, and those credentials open your entire subscription.
What is Nani?+
An IPTV player for Web, Android and Android TV. You connect the IPTV service you subscribed to; Nani provides no channels, no subscription and no content.
Does Nani require Xtream?+
No. Xtream and M3U/M3U8 are its two source types.
Does Nani provide the credentials or the service?+
No. They come from the IPTV service you subscribed to. Nani does not supply them and cannot recover them for you.
What should I check if the connection does not go through?+
The URL copied in full with its port, the username and password with no stray spaces, and whether your subscription is still active with your service. That last one is outside Nani’s reach.
Your Xtream connection. A Nani experience on every screen.
Join the beta list: free sign-up, no credit card. We let you know as soon as your access is available.