How to Set Up IPTV on GSE Smart IPTV via the Xtream Codes API (2026 Guide)

To set up IPTV on GSE Smart IPTV using the Xtream Codes API, open the app, tap the menu icon, select Xtream-Codes API, tap the red (+) button, then enter your server URL (with port), username, and password and tap Add — your live channels, VOD, series, EPG, and Catch-Up all load in one step with no separate playlist file needed. GSE Smart IPTV works this way on Android, iOS, and tvOS (Apple TV).

Unlike a plain M3U link, the Xtream Codes API is a live login connection: GSE talks directly to your provider’s server using three credentials instead of downloading one static playlist file. That difference is why Xtream logins load faster, stay organized into Live TV, Movies, and Series sections, and keep the EPG synced automatically. If you have a RevoIPTV free trial, your Xtream Codes server, username, and password are in your subscriber dashboard the moment you sign up.

Xtream Codes API vs M3U URL: Which Should You Use?

Both methods point to the same channel package, but they behave very differently inside GSE Smart IPTV. An M3U file is simply a plain-text M3U playlist format listing stream URLs one after another, with no built-in EPG or VOD structure. If your provider supports Xtream Codes API — and most modern IPTV services, including RevoIPTV subscriptions, do — it is the better default choice.

In short: use Xtream Codes API whenever your provider offers it. Only fall back to the M3U method if your service doesn’t issue Xtream login credentials.

Before You Start: What You Need

• GSE Smart IPTV installed from the Google Play Store (Android) or the Apple App Store (iOS and tvOS/Apple TV).
• Your Xtream Codes credentials: Server URL (also called Host or Portal URL), Username, and Password — sent by your provider via email or shown in your dashboard.
• A stable internet connection — Wi-Fi or a wired connection is more reliable than mobile data for HD/4K streaming.

How to Add IPTV to GSE Smart IPTV via Xtream Codes API

1. Open GSE Smart IPTV and tap the three-line menu icon in the top-left corner of the home screen.
2. Tap “Xtream-Codes API” from the left-hand navigation list (on some versions this is labeled “Remote Playlists” first, with Xtream Code API as the source type).
3. Tap the red circle (+) button in the bottom-right corner to add a new source.
4. Fill in the connection fields:
   • Server Name — any label you choose, e.g. “RevoIPTV” (for your own reference only).
   • Server URL — your provider’s host address, including the port number, e.g. http://provider.example.com:8080. A missing port is the single most common reason this step fails.
   • Username — from your welcome email or provider dashboard.
   • Password — from the same source; copy-paste it to avoid typos.
5. Tap “Add” and wait for GSE to authenticate. Most connections complete in 10–30 seconds, though a very large international package can take up to a minute.
6. Select your new list from the source menu. Tap LINE to browse live channel groups, or open VOD / Series from the same screen to browse movies and TV shows.

How to Load and Fix EPG in GSE via Xtream Codes API

The Xtream Codes API method pulls the electronic programme guide (EPG) straight from your provider’s server, so in most cases you never touch an XMLTV URL manually.

1. Open your Xtream Codes list inside GSE and tap Install EPG Data.
2. Wait for the download to finish, then tap Electronic Programme Guide to view the full grid with show titles, times, and descriptions.

If the guide looks empty or outdated, work through these fixes in order:

• Force a refresh. Long-press the playlist name and choose Update EPG, or reopen the list and re-run “Install EPG Data.”
• Wait for the channel list to finish loading first. If EPG is requested before the full channel list populates, the guide can fail to map correctly — reload the list, let it finish, then refresh EPG.
• Clear the app cache. On Android, go to device Settings > Apps > GSE Smart IPTV > Storage > Clear Cache, then reopen the guide.
• Confirm the server isn’t temporarily down. If EPG still won’t populate after a refresh and cache clear, the issue is usually on the provider’s end rather than in GSE.

GSE Performance Settings Worth Adjusting

Two settings inside GSE make a noticeable difference once your channels and EPG are working:

• Hardware Decoding — enable this in GSE’s player settings for smoother 4K and high-bitrate playback, since it offloads decoding to your device’s chipset instead of the CPU.
• Buffer Time — increase this to 3–5 seconds if you’re on a variable or slower connection; it trades a slightly longer channel-change time for far fewer freezes and stutters.

Tips for the Best GSE Experience

• Use an external player for stubborn streams. Long-press a channel and choose Play with external player to open it in VLC or another installed app if GSE’s native player struggles with a specific format.
• Pin favourite channels. Long-press any channel to add it to Favourites for one-tap access later.
• Watch for the Catch-Up icon. A small clock icon next to a channel means Catch-Up is available — tap it to browse and replay programmes from previous days.
• Same steps across devices. The Xtream Codes API setup is identical on the Android, iOS, and Apple TV versions of GSE, so you only need to learn it once.

Looking for other players or step-by-step device guides? Browse compatible apps on the RevoIPTV applications page, see the full tutorials hub for TiviMate, IPTV Smarters, and more, or check the GSE Smart IPTV install guide for Firestick, Android, and iOS if you’re setting up on a different device first. Running an IPTV business yourself? See our reseller packages.

FAQ

What is the Xtream Codes API in GSE Smart IPTV?

It’s a login method that connects GSE directly to your provider’s server using a server URL, username, and password. Instead of downloading a static playlist file, GSE authenticates in real time and pulls your live channels, VOD, series, EPG, and Catch-Up together in one organized connection.

What’s the difference between Xtream Codes API and an M3U URL?

Xtream Codes API loads EPG and VOD automatically and keeps content sorted into categories; M3U is a single playlist file that often needs a separate EPG URL and lists everything together. Xtream Codes credentials also tend to stay fixed for your subscription, while some M3U links get rotated periodically by the provider.

Why won’t my GSE channels load after I enter Xtream Codes API details?

The most common cause is a missing port number in the Server URL field, followed by a typo in the username or password, or a temporarily offline server. Recheck all three fields — ideally by copy-pasting from your provider’s welcome email — and confirm your subscription is active.

Why is my EPG not showing up in GSE?

Usually the channel list hasn’t finished loading yet, the app cache is stale, or the EPG data hasn’t been force-refreshed. Reload the playlist, let it fully populate, then long-press it and choose Update EPG; clearing the app cache also resolves most stuck guides.

Is GSE Smart IPTV free?

GSE Smart IPTV is free to download on Android, iOS, and Apple TV, with some optional in-app features on iOS. You still need an active IPTV subscription for content — a RevoIPTV free trial gives you Xtream Codes credentials to test with immediately.

Does GSE Smart IPTV support Catch-Up TV?

Yes, when you connect via Xtream Codes API and your provider offers Catch-Up. Look for the clock icon next to a channel name, then tap it to browse and replay programmes from previous days, similar to a MAG portal.

Can I use the same Xtream Codes API setup on iPhone, iPad, and Apple TV?

Yes. GSE Smart IPTV is available on iOS and tvOS from the Apple App Store, and the Xtream Codes API setup steps are identical to the Android version — same fields, same menu structure.