What Is the Xtream Codes API?
Xtream Codes is an API protocol used by IPTV providers to deliver live TV, video on demand, and TV series to compatible player apps. Instead of loading a single URL like M3U, you enter three separate credentials: a server URL, a username, and a password.
The API communicates directly with the IPTV server, which gives your player app real-time access to channel updates, EPG data, catch-up TV, and content categories — all without needing to refresh or re-enter URLs.
Xtream Codes vs M3U: Which Should You Use?
Both methods connect you to the same channels, but they differ in functionality and app compatibility:
Xtream Codes advantages:
- Automatic EPG integration without a separate guide URL
- Built-in catch-up and timeshift support
- Organized categories for Live TV, Movies, and Series
- Faster channel loading since the app queries the server directly
- Automatic updates when new channels are added
M3U advantages:
- Works with a wider range of apps and devices
- Compatible with VLC, Kodi, and other general media players
- Simpler setup — just one URL to paste
Step-by-Step Xtream Codes Setup
Follow these steps to connect using Xtream Codes on any compatible IPTV player app:
Locate Your Credentials
After subscribing to SecureOnePlan, check your email for three pieces of information: the Server URL (e.g., http://provider.com:port), your Username, and your Password.
Open Your IPTV App
Launch your preferred IPTV app (TiviMate, Smarters Pro, IBO Player, etc.) and look for the option to add a new playlist or provider.
Select Xtream Codes API
Choose "Xtream Codes" or "Xtream Codes API" as the login method. Do not select M3U URL — these are two different input screens.
Enter Your Credentials
Type or paste your Server URL, Username, and Password into the corresponding fields. Make sure the Server URL includes the port number (the numbers after the colon).
Connect and Load Channels
Tap "Login" or "Add." The app will connect to the server and load your channel list, VOD library, and series catalog. This may take 30 to 90 seconds on the first load.
Best Apps for Xtream Codes Login
These apps provide the best experience when connecting via the Xtream Codes API:
TiviMate
The most polished IPTV player with full Xtream Codes support. Features a clean EPG grid, favorites, recording, and multi-screen view. Premium version recommended for multiple playlists.
IPTV Smarters Pro
Cross-platform app with native Xtream Codes login. Organizes content into Live TV, Movies, and Series tabs automatically. Free version available with all essential features.
IBO Player / IBO Pro
Lightweight player popular on Samsung and LG TVs. Supports Xtream Codes with a device-based activation system. Excellent for Smart TV users.
XCIPTV Player
Feature-rich Android player with Xtream Codes support, built-in EPG, catch-up TV, and parental controls. Free with optional premium features.
Advanced Xtream Codes Settings
Once connected, these settings can improve your viewing experience:
User Agent: Some apps let you set a custom user agent string. If streams fail to play, try changing the user agent to a common browser string or leave it as default.
Stream Format: You can often choose between MPEG-TS (.ts) and HLS (.m3u8) output. Use TS for most Android devices and HLS for Apple devices and web players.
EPG Timeshift: If your program guide shows incorrect times, adjust the EPG offset setting. This is usually measured in hours and corrects for timezone differences.
Buffer Size: In apps like TiviMate, you can adjust the buffer size under player settings. Increasing the buffer to 3-5 seconds can reduce playback interruptions on slower connections.
Troubleshooting Xtream Codes Connection Issues
If you cannot connect or channels fail to load, follow these troubleshooting steps:
"Server not found" error: Verify the server URL is correct, including the protocol (http or https) and port number. Try accessing the URL in a web browser — you should see a server response page.
"Authentication failed" error: Re-check your username and password. These are case-sensitive. Copy and paste them directly from your SecureOnePlan welcome email to avoid typos.
Channels load but do not play: Your ISP may be blocking IPTV traffic. Try connecting through a VPN to bypass potential throttling. Also try switching the stream output format in app settings.
App freezes during login: Clear the app cache and data, then try again. On Firestick, go to Settings > Applications > Manage Installed Applications > select your app > Clear Cache.
Only Live TV loads, no VOD: This can happen if the server is temporarily overloaded. Wait a few minutes and reload the playlist. If the issue persists, contact SecureOnePlan support.