HomeGuides › TiviMate Setup: Add an Xtream Codes Playlist

TiviMate Setup: Add an Xtream Codes Playlist

Updated 2026-06-14 · 5 min read

TiviMate is one of the most popular IPTV players for Android TV and Fire TV devices, and its Xtream Codes support means setup is just three fields: server URL, username, and password. This TiviMate Xtream Codes guide walks through adding your playlist, getting the EPG working, and the one thing that makes the setup permanent — a URL that never changes.

TL;DR: Open TiviMate → Add playlist → Xtream Codes → enter URL, username, password → finish. EPG loads automatically. Use a permanent Xtream URL from iptv.domains and you will never need to redo this.

Before you begin

You need three things your IPTV service provides: a server URL (e.g. http://example.com:8080), a username, and a password. If you use iptv.domains as middleware, these credentials are shown in your dashboard's Credentials card and never change — even if you swap the underlying provider.

TiviMate must already be installed on your Android TV or Fire TV device. If you have not installed it yet, see the Firestick setup guide for the sideload process using the Downloader app.

TiviMate Xtream Codes setup — step by step

  1. Open TiviMate on your device. On first launch you will see a welcome screen with an Add playlist button. On subsequent launches, go to Settings → Playlists → Add playlist.
  2. Select Xtream Codes from the list of playlist types. (The other option, M3U URL, also works but Xtream Codes gives TiviMate richer data including separate live, movie, and series categories.)
  3. Enter your Server URL exactly as provided — including the protocol (http:// or https://) and port number if one is given. Do not add a trailing slash unless your provider specifies it.
  4. Enter your Username and Password, then tap Next.
  5. Give the playlist a name (anything you like — it is just a label) and tap Done. TiviMate contacts the server, fetches your channel list and categories, and begins loading everything.

The initial load takes anywhere from a few seconds to a minute or two depending on how large your channel list is. TiviMate shows a progress indicator while it works.

Configuring the EPG (TV guide)

TiviMate fetches your EPG — the electronic programme guide that shows what is on now and next — directly from the same Xtream Codes URL. In most cases it configures itself automatically with no extra steps. If the guide is empty after the first load:

  1. Go to Settings → EPG.
  2. Confirm the EPG URL is set — it should be filled in automatically from the playlist. If it is blank, tap it and enter your server's XMLTV address (your IPTV service or iptv.domains dashboard will show this).
  3. Tap Force Update to trigger an immediate guide download.
Tip: iptv.domains assembles and serves the EPG from the same URL as your channels. If specific channels are missing guide data, the EPG Editor lets you match channels to guide sources manually — no player-side changes needed.

Navigating TiviMate after setup

Once channels load, TiviMate's home screen shows your categories on the left and channels on the right. The bottom bar displays the current and next programme for the selected channel, sourced from your EPG. Key things to know:

  • Favourites: Long-press a channel and select Add to Favourites. Favourites appear as their own category at the top of the list.
  • Catchup / time-shift: Available with the Companion app, if your provider supports it. TiviMate shows a clock icon on compatible channels.
  • Panel layout: TiviMate Companion users can switch to a guide-style grid layout for a more traditional EPG view.
  • Refresh playlist: If you update your channels on iptv.domains (add a provider, hide channels in the playlist editor), go to Settings → Playlists → your playlist → Refresh to pull the latest version.
Example

Laura adds TiviMate to her Android TV box and sets up her Xtream playlist

Laura has an Nvidia Shield connected to her living room TV. She installs TiviMate, opens it, and taps Add playlist → Xtream Codes. She pastes the permanent URL, username, and password from her iptv.domains dashboard, gives the playlist a name, and taps Done. Within thirty seconds her full channel list loads with categories already organised. The EPG populates automatically. She adds her ten most-watched channels to Favourites and is done. Three weeks later she uses iptv.domains' playlist editor to hide categories she never watches — TiviMate refreshes the playlist and shows the slimmed-down list. Zero changes on the device itself.

TiviMate vs other players

TiviMate is a strong choice for users who want a polished, feature-complete experience on an Android TV or Firestick. If you want something lighter and more straightforward, Chillio is a notably user-friendly player with a clean interface that also accepts Xtream Codes. IPTV Smarters Pro is available on more platforms including iOS. And if you prefer one app that works identically on every device, the Xtream Codes login guide shows how all these players use the same three-field login.

iptv.domains is also building Demivo, its own native player that will pair directly with your account. It is currently in development and coming soon.

If the playlist fails to load

  • Authentication error: Re-check your username and password — a single wrong character is enough. Copy-paste from the dashboard rather than typing manually.
  • Cannot connect to server: Confirm the URL is reachable. Try opening it in a browser on the same network to rule out a network issue.
  • Channels load but playback fails: This is usually an upstream provider issue. See the IPTV black screen guide for common causes.

Frequently asked questions

Do I need to pay for TiviMate?

TiviMate itself is free to install. The optional Companion app (a one-time purchase) unlocks multi-playlist support, catchup, and panel layouts. For a single Xtream Codes playlist you can start with the free version.

Where do I find my Xtream Codes URL, username and password?

Your IPTV service provides these three credentials. If you use iptv.domains as your middleware, log in to your dashboard — your permanent URL, username, and password are shown in the Credentials card on your stream page.

Why is my TiviMate EPG empty after adding the playlist?

TiviMate should pull the EPG automatically from the Xtream URL. If the guide stays blank, go to Settings → EPG → Force Update. If you are using iptv.domains, the EPG is served from the same URL and should configure itself — see the EPG Editor guide if channels are still missing guide data.

Can I add more than one playlist to TiviMate?

Yes, with the Companion app you can add multiple playlists and merge them into a unified channel list. If you want a single permanent URL that already combines multiple providers, iptv.domains can do that without needing multiple TiviMate playlists at all.

Does TiviMate work on Firestick?

Yes. TiviMate runs on Android TV and Fire TV devices including all Amazon Fire TV Sticks. It is not in the Amazon Appstore, so you install it via sideload — the setup-iptv-on-firestick guide covers the Downloader method step by step.

Stop re-entering IPTV credentials on every device

iptv.domains gives you one permanent URL, automatic failover, and a full playlist & EPG editor. Free trial, no card required.

Start your free trial →

Related guides