How to Set Up Xtream Codes for IPTV

The quick answer: Xtream Codes is a login method that uses three fields — server URL, username, and password — to connect your IPTV player to the streaming server. Enter these in any player that supports Xtream Codes (TiviMate, IPTV Smarters, GSE Smart), and your channels load automatically. It is faster and more reliable than M3U.

Marinios IPTV provides Xtream Codes credentials with every subscription. If you prefer M3U instead, see our M3U setup guide. Browse all setup guides or visit the setup hub.

What Are Xtream Codes?

Xtream Codes is a server-based authentication system for IPTV. Instead of downloading an entire M3U playlist file, your player logs in to the streaming server using three credentials — a server URL (with optional port), a username, and a password. The server then provides the channel list, EPG data, and stream URLs dynamically. This method is faster, uses less bandwidth, and supports features like catch-up TV and VOD that M3U cannot always provide.

What You Need

• Xtream Codes credentials — server URL, username, and password from your IPTV provider (get a free trial to test).
• An IPTV player with Xtream Codes support — TiviMate, IPTV Smarters, GSE Smart, and others. See our IPTV apps hub.

Understanding Your Credentials

• Server URL: This is the portal address (e.g., http://server.example.com:8080). It includes the protocol (http/https), the domain or IP, and often a port number. Paste it exactly as given — do not add or remove anything.
• Username: Your account username, usually a string of letters and numbers. Case-sensitive.
• Password: Your account password. Also case-sensitive. Watch for leading/trailing spaces if copying from an email.
• Port number: The port is usually included in the server URL (e.g., :8080). If your provider gives the port separately, append it to the server URL. Common ports are 80, 8080, and 25461. If no port is specified, try the URL as-is first.

Step-by-Step: Enter Xtream Codes in Popular Players

TiviMate (Android TV / Firestick)

1. Step 1 — Open TiviMate and select "Add playlist."
2. Step 2 — Choose "Xtream Codes" as the playlist type.
3. Step 3 — Paste the server URL in the first field, enter the username in the second, and the password in the third.
4. Step 4 — Name the playlist (e.g., "Marinios IPTV") and tap "Next."
5. Step 5 — Wait for authentication and channel loading. Full details in our TiviMate guide.

IPTV Smarters Pro (All Platforms)

1. Step 1 — Open IPTV Smarters and select "Login with Xtream Codes API."
2. Step 2 — Enter any name, then paste the server URL, username, and password.
3. Step 3 — Tap "Add User" and wait for the channel list to download. Full details in our IPTV Smarters guide.

GSE Smart IPTV (Android / iOS)

1. Step 1 — Open GSE Smart and tap the + icon to add a remote playlist.
2. Step 2 — Choose "Xtream Codes API" as the type.
3. Step 3 — Enter the server URL, username, and password, then save.

Common Issues & Troubleshooting

• "Authorization failed" or "Invalid credentials": The most common cause is a typo. Re-enter the server URL, username, and password exactly as provided. Watch for case sensitivity and extra spaces. Your subscription may also have expired — see error codes.
• Port number issues: If the URL does not include a port, try appending :8080 or :25461. If the connection still fails, remove the port entirely. Your provider's support can confirm the correct port.
• Device limit reached: Xtream Codes accounts have a maximum number of simultaneous connections. If another device is already connected, disconnect it or upgrade your plan.
• Server temporarily unavailable: Wait 5–10 minutes and try again. Server maintenance is occasional. If it persists, contact your provider's support.

More help in the troubleshooting hub or buffering fixes. For account issues, contact Marinios support 24/7.

Xtream Codes FAQs