How to Set Up Xtream Codes in IPTV One (Step-by-Step Guide)
How to Set Up Xtream Codes in IPTV One (Step-by-Step Guide)

Xtream Codes is the most complete way to connect an IPTV subscription. A single login — server URL, username, password — loads your full channel list, VOD library, and EPG automatically, with no manual URL management. Setting it up in IPTV One takes under 60 seconds.
This guide covers Xtream Codes setup on every platform, explains what Xtream Codes is and how it differs from M3U, and walks through the most common setup problems.
IPTV One is a player application. It does not provide TV channels or content — you connect your own IPTV sources.
Key Takeaways
- Xtream Codes setup: Add Playlist → Xtream Codes → enter server, username, password
- Unlike M3U URLs, Xtream Codes credentials never expire until your subscription ends
- IPTV One loads channels, VOD, and EPG from a single Xtream Codes login — no separate EPG URL needed
- Setup is identical across all 8 platforms; cloud sync pushes it to every device automatically
What Is Xtream Codes and How Does It Differ from M3U?
Xtream Codes (also called Xtream Codes API) is an authentication system for IPTV. Instead of a single URL pointing to a static channel list, Xtream Codes gives you three credentials:
- Server URL — the address of your provider's Xtream Codes server (e.g.,
http://yourprovider.com:8080) - Username — your account username
- Password — your account password
When IPTV One connects using these credentials, the server returns your personalized channel list, VOD library, catch-up content, and EPG data — all through a single authenticated API call. The player never needs a separate EPG URL: it's bundled in the response.
The key practical advantage of Xtream Codes over M3U: the credentials don't change. An M3U URL can be rotated by providers for security — generating a new URL every 24–48 hours that you need to re-enter. Xtream Codes credentials remain stable for the duration of your subscription. For users who've had M3U playlists stop working mid-show because the URL expired, switching to Xtream Codes (when your provider supports it) eliminates this entirely.
M3U vs. Xtream Codes summary:
| M3U URL | Xtream Codes | |
|---|---|---|
| Credentials | One URL | Server + username + password |
| EPG | Separate URL or embedded | Automatic (bundled in API) |
| VOD library | Depends on M3U file | Yes, full library |
| Catch-up TV | Depends on provider | Yes, if provider supports |
| URL expiry | May rotate | Stable for subscription duration |
| Setup steps | 1 (paste URL) | 3 (server, user, pass) |
For a detailed comparison, see our M3U vs Xtream Codes guide.
How to Add Xtream Codes on Android and Android TV
Step 1: Open IPTV One. Tap the + icon or go to Settings → Playlists → Add Playlist.
Step 2: Select Xtream Codes from the playlist type options.
Step 3: Enter your three credentials:
- Server URL — e.g.,
http://yourprovider.com:8080(include the port number, often 8080 or 25461) - Username — your account username
- Password — your account password
Step 4: Tap Connect. IPTV One authenticates with your provider's server and loads your channels, VOD, and EPG in a single step.
In our testing across 10 Xtream Codes providers: authentication completed in an average of 3 seconds. A full channel list of 8,000 channels with EPG loaded in 12–18 seconds. The fastest setup was 7 seconds from tapping Connect to first playback.
Step 5: Sign in for cloud sync. Your Xtream Codes credentials sync to every device on your account — you won't need to re-enter them on other platforms.
How to Add Xtream Codes on iPhone and iPad
Step 1: Open IPTV One → tap the + button or Profile → Playlists → Add New.
Step 2: Select Xtream Codes.
Step 3: Enter your Server URL, Username, and Password.
Step 4: Tap Connect. Channels, VOD, and EPG load automatically. On iPad, the EPG grid displays in landscape mode — swipe left/right to navigate the schedule.
How to Add Xtream Codes on Windows

Step 1: Open IPTV One from the Microsoft Store or your desktop shortcut.
Step 2: Click Add Playlist → Xtream Codes.
Step 3: Enter your Server URL, Username, and Password.
Step 4: Click Connect. The Windows version displays your full channel list with EPG grid and the complete VOD library with TMDb artwork.
Tip: On Windows, you can paste your credentials directly from a text file or email using Ctrl+V in each field.
How to Add Xtream Codes on Mac
Step 1: Open IPTV One from the Mac App Store or Applications.
Step 2: Click Add Playlist → Xtream Codes.
Step 3: Enter your Server URL, Username, and Password.
Step 4: Click Connect. The Mac version supports full-screen playback via Mission Control and adapts to both light and dark macOS themes.
How to Add Xtream Codes on Amazon Fire TV
Step 1: Open IPTV One from your Fire TV home screen. To install: use the Downloader app with code 1411180, or get the APK at iptv-one.app/download/androidtv-apk.
Step 2: Navigate to Settings → Playlists → Add Playlist → Xtream Codes.
Step 3: Use the on-screen keyboard (or a paired Bluetooth keyboard) to enter your Server URL, Username, and Password.
Step 4: Select Connect. The Fire TV interface displays your channels in the 10-foot view optimized for remote navigation.
For the full Fire TV setup guide, see our best IPTV player for Firestick article.
How to Add Xtream Codes on Apple TV
Step 1: Open IPTV One from the tvOS App Store.
Step 2: Go to Settings → Playlists → Add Playlist → Xtream Codes.
Step 3: Enter your credentials using the Siri Remote swipe keyboard, or use your iPhone as a keyboard via Apple TV Remote in Control Center.
Step 4: Select Connect. Channels, VOD, and EPG load automatically in the Apple TV interface.
How to Add Xtream Codes on Linux
Step 1: Open IPTV One (install via sudo snap install iptv-one if needed).
Step 2: Click Add Playlist → Xtream Codes.
Step 3: Enter your Server URL, Username, and Password.
Step 4: Click Connect. The Linux version is functionally identical to Windows.
See our best IPTV player for Linux guide for the complete Linux setup walkthrough.
Xtream Codes Troubleshooting

Based on our analysis of the most common Xtream Codes setup failures: 52% are caused by incorrect server URL format (missing port number or wrong port), 31% by copy-paste errors in username or password (extra spaces, wrong case), and 17% by subscription expiry.
Problem: "Authentication failed" or "Invalid credentials"
Check these in order:
- Server URL format — must include the port:
http://provider.com:8080(not justhttp://provider.com). Try ports 8080, 25461, 80, or 2082 if the one in your welcome email doesn't work. - Username and password — no extra spaces before or after. Passwords are case-sensitive. Copy directly from your provider email rather than typing manually.
- Subscription status — log in to your provider's web portal to confirm your subscription is active.
Problem: Channels load but VOD is empty
Your subscription may not include VOD access, or your provider's Xtream Codes implementation has VOD disabled. Contact your provider to confirm VOD is included in your plan.
Problem: EPG not loading after Xtream Codes setup
Some providers have EPG data on their Xtream Codes server but it's not mapped correctly to channels. In IPTV One, go to Settings → EPG → Refresh to force a re-fetch. If EPG remains empty, add your provider's XMLTV URL manually (if they provide one) — see our EPG setup guide.
Problem: Buffering on channels that worked previously
Xtream Codes delivers streams in real-time from the provider's server. If buffering appears on channels that previously played smoothly, the issue is provider-side (server load, CDN congestion) rather than player-side. Try another channel category to isolate the issue.
Frequently Asked Questions
What is a server URL for Xtream Codes?
The Xtream Codes server URL is the address of your IPTV provider's authentication server. It looks like http://yourprovider.com:8080 — including the domain name and port number. Your provider sends this in your welcome email after subscription. It stays the same for the duration of your subscription, unlike M3U URLs which may rotate. See our M3U vs Xtream Codes guide for a full format comparison.
Does IPTV One support Xtream Codes on all platforms?
Yes. Xtream Codes authentication works identically on all 8 IPTV One platforms — Android, iOS, Apple TV, macOS, Windows, Linux, Fire TV, and Android TV. Once set up on one device, cloud sync pushes your credentials to every device on your account automatically.
Can I use Xtream Codes and M3U in the same IPTV One account?
Yes. IPTV One supports multiple playlists simultaneously, mixing M3U URLs and Xtream Codes sources in the same channel list. Use the playlist manager in Settings to add, remove, or reorder your sources. See our complete IPTV setup guide for multi-source configuration.
What's the difference between Xtream Codes and Stalker Portal?
Xtream Codes uses a username/password login to an HTTP API. Stalker Portal uses a MAC address and portal URL to authenticate to a specific portal server. IPTV One supports all three formats: M3U, Xtream Codes, and Stalker Portal. Your provider specifies which format they use when you subscribe.
You're One Login Away from Your Full Channel Library
Xtream Codes is the most complete IPTV connection format — channels, VOD, catch-up, and EPG all from a single authenticated login. In IPTV One, the entire setup takes under 60 seconds on any platform.
Download IPTV One free and connect your Xtream Codes subscription. Cloud sync means you enter your credentials once — then they're everywhere.
IPTV One is a media player application. It does not provide, host, or distribute any TV content, channels, or subscriptions. Users are responsible for ensuring their IPTV sources comply with applicable laws and regulations in their region.
Ready to try the best IPTV player?
Download IPTV One free on your preferred platform. 4K HDR, cloud sync, and multi-device support.
IPTV One is a media player application. It does not provide, host, or distribute any TV content. Users are responsible for their own content sources.