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.
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
- 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.
- 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.)
- Enter your Server URL exactly as provided — including the protocol (
http://orhttps://) and port number if one is given. Do not add a trailing slash unless your provider specifies it. - Enter your Username and Password, then tap Next.
- 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:
- Go to Settings → EPG.
- 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).
- Tap Force Update to trigger an immediate guide download.
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.
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.