How to Set Up Xtream Codes in IPTV Expert

Here's how to set up Xtream Codes in IPTV Expert: an Xtream Codes login is three or four pieces of text. A server address, a username, a password, sometimes a port typed right into the address. That's the whole thing. What trips people up isn't the data. It's guides that show a different app's screenshots, or skip straight past what happens when the first attempt doesn't work.

This guide covers the exact fields IPTV Expert asks for, in the order it asks for them. Then it covers what its one error screen actually means when something goes wrong, so you can tell a typo from a genuine server problem.

Key takeaways

• IPTV Expert's Xtream Codes form asks for four fields in this order: Name, Server, Username, Password. There's no separate port field — the port goes in the Server value.
• Saving only checks that no field is empty. It does not check whether the Server value looks like a real URL.
• If login fails, IPTV Expert shows one shared "Refresh failed" message for every possible cause — it doesn't tell you whether the problem is the URL, the credentials, the connection or your subscription.

What you need before you start

You need Xtream Codes credentials from a provider you're already authorized to use: a server URL, a username and a password. IPTV Expert doesn't supply, sell or generate Xtream Codes accounts. It plays back whatever a source you already have access to provides.

"Xtream Codes" refers to a login format used by many IPTV panels. Instead of one playlist link, your provider gives you a server address (protocol, host and usually a port, like http://example-provider.com:8080), a username and a password. The app exchanges those three values with the provider's server for your channel and video-on-demand data. That server-side exchange typically returns an authentication field alongside account details like an expiry date and connection limits (Xtream Codes API — Authentication & Account Info reference; background corroborated by the Xtream-UI API documentation). That's why an expired subscription and a wrong password can look similar from the app's side.

If your provider instead gave you a single playlist link rather than three separate credentials, you likely have an M3U source, not Xtream Codes. How to Add an M3U Playlist to IPTV Expert covers that flow. What Is an M3U Playlist? Formats, Examples and Player Setup explains the difference if you're not sure which one you have. Still deciding which player to install in the first place? Best Free IPTV Players in 2026 compares options before you commit to one.

One more thing worth knowing before you're on this screen in public: IPTV Expert's password field doesn't mask what you type. Cover the screen, or avoid entering credentials where someone can see over your shoulder.

Add a Xtream Codes source: the exact steps

Open the add-source screen and pick the "Xtream Codes" option. It sits alongside "M3U/M3U8 Playlist" and "Stalker Portal" in a three-way selector, so make sure you've selected the right one before typing anything.

1. Name. A label for your own reference. It isn't sent anywhere and doesn't need to match anything your provider assigned.
2. Server. The full address including the port, exactly as your provider sent it. The field itself hints at the expected shape with a placeholder like http://example-provider.com:8080, port included, with no separate box for it.
3. Username. Case-sensitive, entered exactly as provided.
4. Password. Also case-sensitive. Neither this field nor Username is trimmed of stray spaces automatically. A copy-paste that grabbed a leading or trailing space gets submitted exactly as pasted.
5. Save.

That's the same four fields, same order, on every platform IPTV Expert ships on. What changes is how you type into them. On phones, tablets and desktop, each field is an inline text box you tap or click into directly. On Android TV and Fire TV, selecting a field with the remote opens a dedicated full-screen keyboard instead — you type the value there, confirm, and focus returns to the form. It's the same interaction pattern already used for adding an M3U playlist on television, just applied to four fields instead of two.

A note on convenience: if you've used other players, you may expect a "paste a full link and auto-fill everything" shortcut on this screen. IPTV Expert doesn't offer that when you're adding a brand-new source — that shortcut only applies later, if you go back and edit a source that's already saved. The first time through, all four fields need to be typed or pasted individually.

What happens after you save the form?

Saving doesn't move you forward if a required field is empty. IPTV Expert flags it instantly with the label "Mandatory" under the field, before you ever leave this screen. That check only confirms something was typed, nothing more. Unlike the Server field on the M3U/M3U8 tab, which gets checked for a well-formed URL, the Xtream Codes Server field has no such format check at save time. A typo that still isn't empty, a missing colon before the port, for instance, will pass this stage and only surface at the next one.

Once every field has something in it, the app moves on and actually contacts the server you entered. That's the real test, and it's where a wrong value shows up.

What does "Refresh failed" mean if Xtream Codes setup fails?

Here's the part most guides skip. If the server exchange doesn't go through, IPTV Expert shows exactly one error screen, titled "Refresh failed." The message underneath reads: "Please verify your internet connection. Double-check your credentials. If the issue persists, contact your content provider for assistance."

That single screen covers every possible cause. It does not tell you which of the following actually happened:

1. The Server value is wrong or incomplete. A missing port, wrong protocol, or a typo in the address.
2. The Username or Password is wrong. This includes a stray space carried over from copy-paste, since neither field is trimmed automatically.
3. The server is temporarily unreachable. A network issue on your side, or on the provider's.
4. The subscription has expired or is otherwise inactive on the provider's side, so the credentials themselves are still "correct" but no longer authorized.

Since the app doesn't separate these for you, work through them in the order they're easiest to rule out:

• Re-check the Server value first, specifically the port. It's the single most common cause of a login that looks broken but isn't.
• Re-check Username and Password for typos and, especially, invisible leading or trailing spaces from a copy-paste.
• Confirm you can reach the internet at all on that device, and if possible, try the same credentials from a different network.
• If everything above checks out, the account itself is the likely cause — contact your provider to confirm the subscription is still active.

Once a login succeeds, the account's expiry date does show up afterward, as an informational line you can check back on later. It just isn't shown as part of the error screen if setup fails before you get there.

Which download should you use?

The setup steps above are identical across every platform. Pick the download that matches the device you're setting up on:

If you already have IPTV Expert installed and just needed the Xtream Codes fields, you're set. Still deciding between devices? Best IPTV Player for Android in 2026 and Best IPTV Player for Mac in 2026 cover the platform-specific picture in more depth. If you're installing for the first time and aren't sure which platform build applies, the full IPTV Expert download chooser covers every supported device.