Home›Blog›TiviMate playlist

TiviMate playlist setup: entering an M3U URL or Xtream Codes login to load IPTV channels

Setup guide

How to add a playlist to TiviMate (M3U and Xtream Codes)

A playlist is the thing that actually fills TiviMate with channels. Add it once and the empty app turns into a full TV guide. Here is how to do it both ways, which method to pick, and how to avoid typing a giant URL with your remote.

By Marcus Webb·Reviewed September 2026·Not affiliated with TiviMate

The quick version. Get your login details from your IPTV provider, then in TiviMate go to Settings → Playlists → Add playlist. Choose Xtream Codes if your provider gave you a server URL, username and password, or M3U if they gave you a single long link. Enter the details, wait a minute or two while the channels load, and you are done. TiviMate has no channels of its own, so the playlist is what supplies them.

First, what a playlist is and where to get it

This trips up almost every new user, so let us clear it up before touching a single setting. TiviMate is a player. It comes with nothing to watch. The playlist is your own IPTV subscription, and it is what carries the channels into the app.

You do not get the playlist from TiviMate or from us. You get it from whichever IPTV provider you pay. After you sign up, they send you one of two things, usually in a welcome email or in your account dashboard:

Xtream Codes

Three separate details: a server URL (something like http://example.com:8080), a username and a password.

An M3U link

One long single URL that already has your username and password baked into it, ending in something like get.php?username=…&password=…

Either one works in TiviMate. If your provider gives you both, use Xtream Codes. More on why in a second.

Xtream Codes vs M3U: which should you pick?

If you have the choice, go with Xtream Codes. Two real reasons. First, you type three short fields instead of one enormous URL, which matters a lot when your only input device is a TV remote. Second, Xtream Codes usually pulls the EPG (the TV guide) automatically, so you get a proper schedule without adding a separate guide source.

Use M3U when that is all your provider offers, or when you are adding a free public playlist that only comes as an M3U link. It works just as well once it is in; it is simply more painful to enter by hand.

	Xtream Codes	M3U link
What you enter	Three short fields (server, username, password)	One long M3U URL
Typing on a TV remote	Easy	Painful by hand
TV guide (EPG)	Usually loaded automatically	Often needs a separate guide source
Best for	Most paid providers	Free public playlists, or a provider that only gives an M3U link
Playback once loaded	Identical	Identical

How to add an Xtream Codes playlist

Open Settings → Playlists

From the TiviMate main screen, open Settings (the gear icon), then choose Playlists.

Add playlist → Xtream Codes

Select Add playlist, then pick Xtream Codes as the type.

Enter your three details

Type the server URL, username and password exactly as your provider sent them. Keep the port on the URL (the :8080 or similar at the end) and watch for stray spaces. Then choose Next.

Let it process, then Done

TiviMate loads your channels. On a large list this takes a minute or two and shows “Please wait”. When it finishes, choose Done and press back to reach the guide. The EPG usually fills in on its own shortly after.

How to add an M3U playlist

The steps are the same, you just pick a different type.

Settings → Playlists → Add playlist

Same path as above. This time choose M3U Playlist.

Paste the full M3U URL

Enter the entire link your provider gave you, from http:// all the way to the end. Missing the port number or dropping the tail of the URL is the most common reason it fails. If you have an M3U file instead of a link, you can point TiviMate to it, but a URL is simpler.

Next, wait, Done

Let the channels load and choose Done. With a plain M3U you may need to add an EPG source separately; our TiviMate EPG guide covers that.

The trick to avoid typing a URL with your remote

This is the part every guide skips and everyone hates. Pecking out a long M3U link one character at a time on an on-screen keyboard is genuinely miserable. A few ways to skip it:

Use the phone remote app

The Android TV or Google TV remote app on your phone lets you type on your phone keyboard and, crucially, paste. Copy the URL on your phone, open the remote app, and paste it straight into the TiviMate field.

Prefer Xtream Codes

Three short fields beat one 120-character URL every time. If your provider offers Xtream, this alone saves most of the pain.

Pair a Bluetooth keyboard

Any cheap Bluetooth keyboard connects to a Fire Stick or Android box and makes entry trivial. Handy if you set up devices often.

Free playlists: worth it?

People ask constantly for free M3U playlists. Here is the honest answer. Free public playlists do exist for legal, free-to-air channels, and community projects on GitHub such as iptv-org collect them. They are fine as a backup for news and local networks.

But be realistic: free lists are often half-dead, with most channels blank or dropping out within weeks, and the EPG is patchy. If you want reliability and a full guide, a paid provider is the difference between a toy and a tool. Whatever you use, remember TiviMate does not police your source, so stick to services you trust.

Adding more than one playlist

One of the best reasons to unlock TiviMate Premium is multiple playlists. The free version holds a single playlist; Premium lets you stack several and merge them into one guide, so you can keep, say, a paid service and a free backup side by side. You add each one exactly as above, and TiviMate blends them.

Playlist not loading? Quick fixes

Check the URL carefully

No leading or trailing spaces, and keep the port (:80, :8080). One wrong character and it fails. Copy-paste rather than retype.

Test the link in a browser

Paste the URL into a browser on your phone. If nothing loads there, the link is wrong or your provider’s server is down, and it is not a TiviMate problem.

Try a VPN

Some ISPs block IPTV traffic, which shows up as a playlist that will not load. A VPN quickly tells you if that is the cause.

Still stuck?

See TiviMate not working and the HTTP Data Source Exception fix for the deeper cases.

TiviMate playlist FAQ

Where do I get a playlist for TiviMate?

From your IPTV provider, not from TiviMate. After subscribing, they send you either Xtream Codes (server URL, username, password) or a single M3U link, usually by email or in your account dashboard.

What is the difference between M3U and Xtream Codes?

They are two formats for the same subscription. Xtream Codes is three short fields and usually loads the EPG automatically. M3U is one long URL. If your provider offers both, Xtream Codes is easier to enter and manage.

How do I add an M3U URL to TiviMate?

Go to Settings, then Playlists, then Add playlist, choose M3U Playlist, and paste the full URL including the port. Let the channels load and choose Done.

Can I add more than one playlist?

Yes, but the free version is limited to one. TiviMate Premium lets you add several playlists and merge them into a single guide.

Are there free TiviMate playlists?

Yes, for legal free-to-air channels through projects like iptv-org on GitHub, but they are unreliable and often mostly blank. A paid provider is far more stable and comes with a proper EPG.

My playlist will not load. Why?

Usually a URL typo, a missing port, or an expired subscription. Copy-paste the link, keep the port, test it in a browser, and try a VPN if your ISP might be blocking it.