Xtream Codes API vs M3U playlist: which to use?
Use Xtream Codes if your operator sent you a username, password and server URL separately. Use M3U if you received a single URL with ".m3u" or "m3u_plus".
IPTV Smarters Pro supports two connection methods. Which to use depends on what your operator provides. Activation is done inside the app after choosing the method.
| Criterion | Xtream Codes API | M3U Playlist |
|---|---|---|
| Operator provides | Server URL + username + password | A .m3u or .m3u8 file URL |
| Automatic playlist update | Yes (app queries the server) | Only if the URL is dynamic |
| Integrated EPG support | Yes (via Xtream Codes) | Depends on the operator |
| Catch-up / recording | Yes (if the server supports it) | Limited |
| Series and VOD organised | Yes (separate sections) | In a single list |
| Compatible with all devices | Yes | Yes |
Practical rule: if the operator sends a username, password and server URL separately, use Xtream Codes. If they send a single URL with ".m3u" or "m3u_plus", use M3U playlist.
Set up with Xtream Codes API — step by step
What you need: server URL (e.g. http://server.example.com:8080), username and password provided by your operator.
Step 1 — Open IPTV Smarters Pro On the welcome screen, press "Add User" (or the "+" icon if you already have profiles).
Step 2 — Select the method Choose "Xtream Codes API".
Step 3 — Fill in the fields
- Username: copy directly from the operator's email or message. Do not add spaces.
- Password: same. Watch out for special characters like @, # or / that may be copied incorrectly.
- Server URL: enter the full URL with port. Usual format: http://server.com:port. Do not add / at the end.
Step 4 — Confirm and wait Press "Add User". The app connects to the server, validates credentials and loads the list. If an error appears, check the typing errors section below.
Step 5 — Verify loading After successful authentication, IPTV Smarters Pro displays the channel groups. If the list is empty, the problem is on the operator's server or with the credentials — not the app.
Set up with M3U playlist — step by step
What you need: an M3U playlist URL provided by your operator (usually starts with http:// or https:// and ends in .m3u, .m3u8 or includes the parameter type=m3u_plus).
Step 1 — Open IPTV Smarters Pro Press "Add User".
Step 2 — Select the method Choose "M3U URL / External playlist" (the label may vary slightly by app version).
Step 3 — Enter the URL
Paste the full URL in the indicated field. If the URL includes parameters (e.g. ?username=x&password=y), copy it in full, with no line breaks.
Step 4 — Name the profile Give the profile a name (e.g. "Home") to make it easier to manage if you have multiple lists.
Step 5 — Wait for loading The app downloads the M3U file and creates the channel groups. Large lists (over 10,000 entries) can take 1 to 3 minutes on first load.
About M3U playlists and EPG: if the operator does not include the EPG URL inside the M3U file itself, you will need to enter it manually in Settings. See the full EPG guide.
Most common typing errors during setup
These errors account for most authentication failures:
1. Space at the beginning or end of a field
When copying credentials from an email or message, it is easy to include an invisible space before or after the text. Solution: clear the field completely and retype manually, or use "paste" carefully.
2. URL missing the port or with wrong port
The correct format is http://server.com:8080. Forgetting :8080 (or the specific port number from your operator) prevents the connection. Check your operator's email carefully.
3. HTTPS instead of HTTP (or vice versa)
Some servers use HTTP, others HTTPS. If your operator specifies http://, do not change it to https:// on your own.
4. Trailing "/" at the end of the server URL
The server URL field should not end with /. http://server.com:8080/ causes errors on some servers.
5. Uppercase where there should be lowercase
Usernames and passwords are case-sensitive. User123 and user123 are different credentials.
6. Special characters copied incorrectly
Symbols like @, &, # may be altered in some email clients or messaging apps. If the password contains them, confirm the original value with your operator.
If you have corrected all these points and the error persists, the problem may be an expired account or the operator's server being unavailable. See the login failure guide.
How to identify and verify the server URL
The Xtream Codes server URL always has this structure:
http://server.example.com:PORT
Where PORT is a number between 1 and 65535 (usually 80, 8080, 25461 or others). The operator communicates this information when sending credentials.
How to test the URL manually:
Open a browser on your phone or computer and enter:
http://server.com:port/get.php?username=YOUR_USER&password=YOUR_PASS&type=m3u_plus
If the server responds with an M3U file or channel text, the URL and credentials are correct. If you get a connection error or blank page, the server is unavailable or the data is wrong.
Server URL vs stream URL: Do not confuse the base server URL (which you enter in the app) with an individual channel URL (stream). They are different things — the app uses the base URL to authenticate and generates stream URLs automatically.
Compatible stream players: IPTV Smarters Pro includes ExoPlayer (internal player) and supports VLC. If a stream works in VLC but not in ExoPlayer (or vice versa), the issue is the codec, not the server.
Technical reference: Xtream Codes protocol documentation and official publisher support.
Last updated: — Smarters Pros editorial team.
Can I have Xtream Codes and M3U in the same profile?
No. Each profile uses one method. You can, however, create multiple profiles in the app — one with Xtream Codes and another with M3U — and switch between them.
What if the server rejects credentials but the operator says they are correct?
Test the URL manually in a browser (see section above). If it works in the browser but not in the app, try reinstalling IPTV Smarters Pro. If it does not work in the browser either, the problem is on the operator's server.
The app asks for an EPG URL — what should I enter?
The EPG URL is provided by your operator or included automatically with Xtream Codes accounts. If you do not have it, leave it blank or see the EPG guide.
Can I use a local M3U file (saved on my phone)?
In some app versions it is possible to load a local M3U file. However, this option is not available on all platforms. Connecting via URL is more reliable.
How long does it take to load a large list?
Lists with over 10,000 channels can take 2 to 5 minutes on first sync, depending on connection speed and device.
Is the configuration saved if I reinstall the app?
No. Settings are stored locally. After reinstalling, you will need to add the profile again.