How to Set Up Xtream Codes on Fire Stick & Android TV (2026)

Xtream Codes is the login system used by the majority of premium IPTV services. Instead of a static M3U file that needs to be manually updated, Xtream Codes provides a dynamic connection using three credentials — a server URL, a username, and a password — that your IPTV app uses to pull a live, always-updated channel list directly from your provider's servers.

If your IPTV service gave you a server URL, username, and password (rather than an M3U link), you are using Xtream Codes. This guide explains exactly how to set it up across every major IPTV app and device.

If you don't yet have an IPTV subscription that provides Xtream Codes credentials, read our guide to choosing an IPTV service first. For UK-focused IPTV with Xtream Codes support, see the IG IPTV Complete UK Guide 2026. For a broader technology overview see the IPTV — The Complete Guide 2026.

What Is Xtream Codes?

Xtream Codes (also known as Xtream Codes API or XC API) is a middleware protocol originally developed as a software product for IPTV operators to manage their subscriber base and content delivery. The original company was shut down in 2019 following legal action, but the protocol lives on — virtually every modern IPTV service still uses Xtream Codes format for credential delivery.

When your IPTV provider gives you Xtream Codes credentials, you typically receive:

• Server URL: e.g., http://yourprovider.com:8080 or http://yourprovider.com
• Username: e.g., johndoe123
• Password: e.g., abc456xyz

These three pieces of information are entered into your IPTV app and the app does the rest — downloading your channel list, EPG data, VOD library, and series catalogue automatically.

Xtream Codes vs M3U Playlist: What's the Difference?

For most users on a modern IPTV app, Xtream Codes provides a significantly better experience than a plain M3U URL.

How to Set Up Xtream Codes in TiviMate (Fire TV / Android TV)

TiviMate is the most popular IPTV app for Fire TV Stick and Android TV. Here is how to add Xtream Codes credentials:

1. Open TiviMate.
2. If this is your first time opening TiviMate, you will be prompted to add a playlist. Select "Add playlist".
   • If TiviMate is already set up and you are adding a second playlist: go to Settings → Playlists → Add playlist.
3. Select "Xtream Codes API".
4. Enter your credentials:
   • Name: Give this playlist a name (e.g., "IG IPTV")
   • URL: Enter your server URL (e.g., http://yourprovider.com:8080)
   • Username: Enter your username
   • Password: Enter your password
5. Tap "Add".

TiviMate will connect to the server, download your channel list, and begin importing EPG data. The first import may take 1–3 minutes for large channel libraries. Once complete, your channels appear in TiviMate's TV guide.

How to Set Up Xtream Codes in IPTV Smarters Pro

IPTV Smarters Pro supports Xtream Codes on all platforms — Android, iOS, Fire TV, Apple TV, Windows, and Mac.

1. Open IPTV Smarters Pro.
2. On the main screen, select "Add User" or "+" (depending on the version).
3. Select "Login with Xtream Codes API".
4. Fill in:
   • Any Name: A label for this account (e.g., "My IPTV")
   • UserName: Your username
   • Password: Your password
   • URL: Your server URL
5. Tap "Add User".

The app will load your channels into four sections: Live TV, Movies, Series, and (if supported) Catch-Up.

How to Set Up Xtream Codes in GSE Smart IPTV (iOS / Apple TV)

1. Open GSE Smart IPTV.
2. Tap the menu icon (three lines, top left).
3. Select "Remote Playlists".
4. Tap the "+" button.
5. Select "Xtream Code Login".
6. Enter:
   • Name: A label for your subscription
   • URL: Your server URL
   • Username: Your username
   • Password: Your password
7. Tap "Add".

Your channels will appear in the GSE Smart IPTV channel list, organised by the groups defined in your service.

How to Set Up Xtream Codes in XCIPTV Player

1. Open XCIPTV Player.
2. Tap "Add account".
3. Select "Xtream Codes".
4. Enter your Server URL, Username, and Password.
5. Tap "Connect".

XCIPTV will load your channel list in its visual card-based interface, with separate sections for Live TV, Movies, and Series.

How to Convert Xtream Codes to an M3U URL

If your IPTV app does not support Xtream Codes directly (such as Kodi's PVR IPTV Simple Client, VLC, or some Smart TV apps), you can convert your Xtream Codes credentials to an M3U URL:

Your M3U URL format:

http://[YOUR_SERVER]:[PORT]/get.php?username=[USERNAME]&password=[PASSWORD]&type=m3u_plus

Replace [YOUR_SERVER], [PORT], [USERNAME], and [PASSWORD] with your actual credentials.

Example:

http://yourprovider.com:8080/get.php?username=johndoe123&password=abc456xyz&type=m3u_plus

Paste this URL wherever an M3U URL is required.

For EPG only (XMLTV format):

http://[YOUR_SERVER]:[PORT]/xmltv.php?username=[USERNAME]&password=[PASSWORD]

How to Check Your Xtream Codes Account Status

You can check your account status, expiry date, connection count, and active streams by visiting your server URL in a browser:

http://[YOUR_SERVER]:[PORT]/player_api.php?username=[USERNAME]&password=[PASSWORD]

This returns a JSON response containing:

• Account active status
• Expiry date (Unix timestamp)
• Max connections allowed
• Currently active connections
• Server info and timezone

This is useful for:

• Confirming your credentials are correct (if not, you will get an error)
• Checking how many days remain on your subscription
• Verifying whether you have exceeded your connection limit

Troubleshooting Xtream Codes Connection Issues

"Wrong username or password" error

• Double-check that you have entered the credentials exactly as provided — copy/paste rather than typing manually to avoid errors
• Verify that the server URL includes the port number if required (e.g., :8080)
• Confirm your subscription is active by checking with your provider

Channels load but no EPG

• Most Xtream Codes apps automatically load EPG data. Allow 5–10 minutes after initial channel load.
• Verify your provider supports EPG data via Xtream Codes (most do)
• In TiviMate: go to Settings → EPG and set the EPG update time

"Too many connections" error

• Your subscription has a limit on simultaneous connections (typically 1 or 2)
• Close IPTV on any other devices currently connected with the same credentials
• Contact your provider if you frequently hit the connection limit and need to upgrade your plan

Channels load but some don't play

• Test the specific non-playing channels on an alternate IPTV app to confirm whether it is an app issue or a server issue
• Some channels in your service may be on different servers with temporary issues
• Contact your provider about any consistently non-playing channels

Frequently Asked Questions

What is the Xtream Codes API port? The most common ports are 80, 8080, and 443. Your provider will specify the correct port in the server URL they give you (e.g., http://provider.com:8080). If no port is specified in the URL, it defaults to port 80 (HTTP) or 443 (HTTPS).

Can I use Xtream Codes credentials on multiple devices? Yes, but only up to the connection limit specified in your subscription. Most single-connection plans allow one device at a time; multi-connection plans allow 2–4 simultaneous streams. Using the same credentials on more devices than your plan allows will trigger a "too many connections" error.

Are Xtream Codes credentials the same as my M3U URL? They are two different formats for accessing the same service. Xtream Codes credentials (server URL + username + password) are the more advanced format, supporting automatic channel updates, EPG, VOD, and series sections. An M3U URL is a generated snapshot of your channel list at the time it was generated.

Does TiviMate support Xtream Codes? Yes. TiviMate has native Xtream Codes support, making it one of the easiest apps to set up with an Xtream Codes-based IPTV service.

Can I use Xtream Codes on Kodi? Not directly through the PVR IPTV Simple Client — it only supports M3U. However, you can convert your Xtream Codes credentials to an M3U URL (see the conversion section above) and use that URL in Kodi.