Short answer: TiviMate is a TV-style front end. It reads a channel list from a link or login you give it, matches that list against a separate guide file, and hands each stream address to Android's video engine to play. Recording and catch-up are just two more ways of fetching the same streams. The catch is that almost everything you see, including picture quality, guide accuracy and whether catch-up exists, comes from the service behind the playlist, not from TiviMate.
At a glance
TiviMate under the hood
| What it reads | M3U playlist, Xtream login or Stalker portal |
| Where the guide comes from | An XMLTV file, matched by channel ID |
| How it plays | Android's hardware video decoder |
| Recording | Saves the incoming stream to storage (Premium) |
| What it never supplies | Channels, rights or stream quality |
Four layers, two owners
The easiest way to understand TiviMate is to split what you see on screen into layers and ask who owns each one.
| Layer | What it is | Who provides it |
|---|---|---|
| Channel list | Names, logos, groups and stream addresses | Your TV service |
| Guide data | Programme titles and times | Your service, or a separate EPG source |
| Video streams | The actual picture and sound | Your service's servers |
| Interface | Grid guide, menus, favourites, recording, multi-view | TiviMate |
Only the bottom row is TiviMate. That's why the developer's own Play listing describes it as "a player only" with no sources of TV channels, and why two people running the same version can have completely different experiences. Their playlists differ; the app doesn't.
Everything below walks through what TiviMate does with the top three layers.
Step 1: reading the playlist
When you add a playlist, TiviMate asks which of three formats you have. Each one delivers the same information in a different shape.
M3U playlist. A plain text file at a web address. Each channel is two lines: an #EXTINF line carrying attributes, then the stream URL. The attributes that matter are tvg-id (the guide ID), tvg-logo, group-title (which becomes the channel group) and, sometimes, catch-up hints. TiviMate downloads the whole file, parses it, and stores the result in a local database on the device. A 10,000-channel M3U can run to several megabytes, which is why first loads take a while on a cheap stick. Our M3U explainer shows a real entry line by line.
Xtream Codes login. A server address, username and password. Instead of one big file, TiviMate calls the server's API and gets structured lists back: live categories, live streams, films, series and account details such as the expiry date and the number of allowed connections. That's why Xtream logins usually "just work" with a guide and on-demand sections, and why TiviMate can show your subscription expiry.
Stalker portal. A portal address plus the device's MAC address, the system MAG set-top boxes use. TiviMate presents a MAC that the provider registers, then talks to the portal the way a MAG box would.
After the first load, TiviMate refreshes the list on a schedule or at start-up, depending on your settings. Hidden groups, favourites, custom numbers and logos are stored on top of that list, keyed to each channel, which is why a provider renaming channels can sometimes scramble your favourites.
Step 2: building the guide
The grid guide is the feature people praise most, and it's built from a completely separate file.
The source. Guide data comes as XMLTV, a standard XML format listing channels and programmes with start and stop times. Xtream logins usually include an XMLTV address automatically. M3U playlists may name one in their header (url-tvg), or you add it yourself in the playlist's EPG settings.
The match. TiviMate links each channel in your playlist to a channel in the guide file using the tvg-id. If the IDs match, programmes appear. If they don't, the row stays empty. Where IDs are missing, you can pick the right guide channel by hand from the channel's options. That's the whole reason "my guide is empty" is so often a provider issue: the IDs in one file don't line up with the other.
The storage. TiviMate downloads the guide, keeps the days you've asked for, and stores them locally so scrolling is instant. Keeping fourteen days of guide for thousands of channels uses memory and slows start-up on low-end hardware. Three or four days is usually plenty.
The clock. XMLTV times carry a time-zone offset. If programmes appear an hour early or late, the fix is the per-source time shift in TiviMate, not your TV's clock. Our EPG guide goes deeper on sources and matching.
Step 3: pressing play
When you select a channel, TiviMate takes the stream URL from its database and hands it to a video engine running on Android. Everything that follows is a conversation between your device and the provider's server.
-
The stream format is usually HLS (a
.m3u8list of short video chunks) or a continuous MPEG transport stream (.ts). TiviMate's Xtream settings let you choose which the server should send. - Decoding is normally done by the device's hardware decoder, which is efficient and handles H.264 and HEVC well. A per-channel switch to software decoding exists for streams that show black screens or coloured blocks.
- The buffer holds a few seconds of video before playback starts. A larger buffer rides out network dips; it also adds delay when changing channel and puts you further behind live.
- Auto frame rate, where supported, asks the TV to switch its refresh rate to match the stream (50 or 60 frames a second, say), which removes judder on sport.
Notice what's missing: TiviMate doesn't re-encode, upscale or clean up the picture. A soft, blocky stream looks soft and blocky in any player. If channels stall at peak times, the bottleneck is the server or your network, not the player.
How catch-up works
Catch-up looks like magic in the guide: scroll back, press a programme that aired yesterday, and it plays. TiviMate isn't storing anything for you. It's asking the provider's archive.
Providers that support catch-up keep recent hours or days of selected channels on their servers. The playlist advertises this per channel, either through Xtream account data (a flag and the number of archive days) or M3U attributes such as catchup, catchup-days and catchup-source. When you pick a past programme, TiviMate builds a request containing the channel, start time and duration from the guide, and the server sends that slice.
Three consequences follow:
- No archive on the provider's side means no catch-up, whatever app you use.
- Guide times must be right, or you'll land in the middle of the wrong programme.
- Catch-up is a Premium feature in TiviMate, so it needs both a supporting provider and a Premium licence.
Licensed services that offer a replay window handle this inside their own apps.
How recording works
Recording in TiviMate is simpler than it sounds. When a recording starts, TiviMate opens the stream just as it would to play it and writes the incoming data to a file instead of, or as well as, showing it.
| Question | What actually happens |
|---|---|
| When does it start? | At the guide's start time, plus any padding you set |
| Where does it go? | Internal storage, a USB drive or a network folder |
| How big is it? | Whatever the stream's bitrate is; an HD hour is often 2-4 GB |
| Does it use a connection? | Yes, one per recording, counted by your provider |
| Does the box need to be on? | Yes; it's a local recording, not a cloud DVR |
That connection point catches people out. If your service allows two simultaneous streams, recording one channel while watching another uses both, and anyone else in the house gets an error. Because recordings follow the guide, a match that overruns stops when the guide says it ends unless you added padding. Licensed services usually offer a cloud DVR instead, which avoids storage and connection limits; our recording and DVR guide compares the options.
How multi-view works
Multi-view, another Premium feature, puts two to four channels on screen at once. Mechanically it's just several of the playback pipelines described above running side by side, and that has costs most guides skip.
- Each tile is a full stream. Four tiles means four simultaneous connections to your provider and four times the bandwidth. A four-way split of HD sport can need 25-30 Mbps on its own.
- Each tile needs a decoder. Hardware decoders on cheap sticks can usually handle one or two HD streams comfortably, not four. Strong boxes such as the Nvidia Shield and Google TV Streamer cope far better, which is why multi-view reviews vary so much.
- Only one tile has sound. You choose which; the others play muted.
- Tiles drift. Each stream buffers independently, so the same match on two feeds won't be perfectly in sync.
If your service allows two streams, two-tile multi-view uses your whole allowance. That's fine on a quiet evening and a problem when someone else switches on a TV upstairs.
The account and Premium layer
Separate from your playlist, TiviMate has its own account system for licensing. Premium has been purchased through the TiviMate Companion app on an Android phone or the developer's website, and each TV device unlocks Premium by signing in to that TiviMate account, up to five devices.
This account knows nothing about your channels. It doesn't sync playlists or favourites between devices either; that's what the Premium backup and restore feature is for. Free users can still run the app, with one playlist and no recording, catch-up or multi-view. The split is set out in our free vs Premium guide.
What TiviMate never touches
It's worth being clear about the limits, because they shape every buying decision around the app.
- Content and rights. TiviMate doesn't supply, licence or vet channels. Whether what you watch is legal depends entirely on where the playlist comes from. A licensed service is fine; an unlicensed "every channel" list isn't made legal by a reputable player.
- Stream quality. It plays what the server sends.
- Your connection limit. The provider counts streams; TiviMate just opens them.
- Blocks and outages. If a source is taken down, the app can't route around it, and shouldn't.
Understood this way, TiviMate is a very good remote-control interface for a playlist you're entitled to watch. Our setup guide covers the practical first steps.
Quick answers
How does TiviMate get channels? It doesn't have any. It reads an M3U playlist, Xtream login or Stalker portal from your TV service and lists the channels that service provides.
Where does TiviMate's TV guide come from? From an XMLTV guide file supplied by your service or added separately. TiviMate matches guide entries to channels using each channel's tvg-id.
Why are some guide rows empty? The channel's ID in the playlist doesn't match any channel in the guide file. You can assign the right guide entry manually.
Does TiviMate store catch-up programmes? No. Catch-up plays from your provider's server archive. If the provider has no archive, catch-up isn't available.
Where do TiviMate recordings go? To internal storage, a USB drive or a network folder that you choose. Each recording also uses one of your provider's simultaneous connections.
Does TiviMate improve picture quality? No. It decodes and displays the stream the server sends; it doesn't upscale or re-encode.
Is TiviMate legal? The app is a player and is legal to use. Legality depends on the content you load: a licensed service is fine, an unlicensed playlist isn't.
TiviMate's menus and the split between free and Premium features change between versions, and providers vary in how they deliver playlists, guides and catch-up. The mechanics described here reflect TiviMate 5.x as of 2026. Checked October 2026.