Guide

Xtream Codes on iPhone and iPad

Your provider gave you a portal URL, a username and a password instead of a playlist link. Those three fields go into PixelPlay in under a minute.

Get PixelPlay free

iOS 17+  ·  Xtream Codes works on the free tier

Three fields

What your provider sent you

Some IPTV providers hand out a link ending in .m3u. Others run an Xtream Codes server and give you three pieces of login instead: a portal URL, a username and a password. Both deliver the same channels.

The difference shows up later. A downloaded M3U file is a snapshot, so you import it again when your provider changes the line-up. An Xtream login stays current: PixelPlay syncs it again when you open the app and the last sync is more than 12 hours old.

Setup

Connect it in PixelPlay

01

Open Settings, then Content Sources

Settings sits in the tab bar. Content Sources is the first row under the Content heading.

PixelPlay Settings on iPhone, with Content Sources as the first row under Content
02

Tap + in the top right

Four cards appear: Free Public Catalog, Remote M3U URL, Local M3U File and Xtream Portal.

The Content Sources sheet in PixelPlay with four cards: Free Public Catalog, Remote M3U URL, Local M3U File and Xtream Portal
03

Choose Xtream Portal

The form asks for a name and three credentials.

04

Name the source

Anything you will recognise later. The placeholder suggests My Provider. This label is yours; it never reaches the server.

05

Enter the portal URL, including the port

The field shows the shape it wants: https://server.com:8080. Most Xtream providers run on a port, and leaving it off is the single most common reason a login fails. Copy the whole thing, port included.

06

Enter your username and password

Paste rather than retype. A trailing space from a copied email will fail authentication and looks identical to a wrong password.

The Xtream Portal form with a name, a portal URL that includes the port, and a username
07

Tap Save

Save stays greyed out until all four fields hold something. PixelPlay then shows Authenticating & Syncing while it checks the login and pulls your channel list. Large playlists take a moment.

Your credentials

Where your password goes

PixelPlay writes your Xtream password to the iOS Keychain, which encrypts it with hardware backing. The app never uploads it to us, and we never see it.

Your portal URL and username sit in the app's own database on the device. Deleting the source removes all three. The full detail lives in the privacy policy.

Before you troubleshoot

Check the login outside the app

Our Playlist Health Check accepts Xtream credentials and tests every channel on the line. Run it when you want to know whether the provider is down or the app is at fault. It asks for no signup and keeps no record of the check.

Test my Xtream login →
When it fails

The three errors you will see

A

Enter the full portal address

The full message ends including http:// or https://. PixelPlay shows it before it contacts the server, when the portal has no scheme in front or no server name after it. Copy the portal again exactly as your provider wrote it, scheme and port included, and check for a stray space.

PixelPlay asking for the full portal address, including http:// or https://, after a portal was typed without one
B

Incorrect username or password

The server answered and turned the login down. Check both fields against the email your provider sent, because they are usually case-sensitive, and look for a trailing space a copied field can carry. A username typed slightly wrong produces the same message as a wrong password.

C

The provider's server didn't respond

PixelPlay could not reach the server at all. A portal copied without its port is the usual cause on a working line, since the app then knocks on a port the server is not listening on. Otherwise the server may be down for a while, so try again in a few minutes.

All three come from the login step, before any channel plays. Problems that appear after the channel list loads belong in playback troubleshooting.

Cost

What this costs you

Nothing. The free tier carries one custom source and keeps it for good, and an Xtream account counts as that source. You get live playback, pause and rewind, favourites with sync, now-and-next programme info, AirPlay and Google Cast alongside it.

Adding a second source is where PixelPlay Pro starts. Get it as a one-time lifetime purchase, or subscribe yearly with a free trial. Pro also adds Picture-in-Picture, Multi-View and locks behind Face ID, Touch ID or your device passcode.

Questions

Xtream Codes on iOS

Still stuck

Send us the symptom

Tell us which of the three errors you see and what your provider's portal looks like, with the password left out. We answer within 24 hours, Monday to Saturday.

support@srstech.in

Never send your Xtream password, to us or to anyone else.
Working from a playlist link instead? Read the M3U setup guide.