Skip to content
Independent IPTV guides, legal use only
  • Try “firestick”, “buffering” or “EPG”

Weekly email

Get the weekly IPTV fix

One email a week with new guides, app updates worth knowing about, and fixes for whatever broke. No spam.

Setup Guides

How to Add an M3U Playlist or Xtream Codes Login to TiviMate

TiviMate asks what kind of playlist you have before anything else. Here's how to tell which one you've got, add it without typos, and fix it when it won't load.

IPTVTips Editorial Team6 min read

Checked for accuracy on November 3, 2026

A hand holding a remote in front of a TV showing rows of film posters
Photo: rawpixel (CC0)
On this page
  1. Quick steps
  2. Which type do you have?
  3. Adding an Xtream Codes login
  4. Adding an M3U playlist link
  5. Typing long links without losing your mind
  6. When the playlist won't load
  7. Is there a free M3U playlist for TiviMate?
  8. Adding a second playlist
  9. Editing or replacing a playlist later
  10. After it loads
  11. Frequently asked questions

Quick stepsabout 10 min

  1. 1

    Work out what your service sent you. One long link is an M3U playlist. A server address plus a username and password is an Xtream Codes login. A portal address used with your device's MAC address is a Stalker portal.

  2. 2

    Open Add playlist. On first launch TiviMate shows Add playlist. Later, find it under Settings, Playlists, Add playlist.

  3. 3

    Choose the matching type and enter the details. Pick M3U playlist or Xtream Codes and type the link or login exactly, including http or https and any port number.

  4. 4

    Let TiviMate process the playlist. Wait while it counts channels, films and series. If it shows 0 channels or an error, check the details before trying again.

  5. 5

    Name the playlist and finish. Give it a short name, confirm, and TiviMate opens the TV guide with your channels.

To add a playlist to TiviMate, open the app, choose Add playlist, pick the type that matches what your service sent you (M3U playlist or Xtream Codes), type the details exactly, and give it a name. It takes about five minutes. Most problems come from choosing the wrong type or a single typo, so here's how to get both right the first time.

This guide assumes TiviMate is already installed. If it isn't, see our Firestick setup guide (or install it from Google Play on Android TV and Google TV).

Which type do you have?

Look at the email or message your service sent. It will contain one of these:

What you were givenWhat it isChoose in TiviMate
One long link, often containing get.php, .m3u or type=m3u_plusM3U playlist URLM3U playlist
A server address (like http://example.com:8080), a username and a passwordXtream Codes loginXtream Codes
A portal address, and you were asked for your device's MAC addressStalker portalStalker portal

Many services give you both an M3U link and Xtream details. If you have the choice, use Xtream Codes. It pulls in the TV guide, films and series automatically and keeps them updated, whereas an M3U link is closer to a fixed list that sometimes needs a separate guide link. We explain the difference properly in M3U vs Xtream Codes.

Tip: an M3U link often contains the Xtream details inside it. In a link like http://server:port/get.php?username=AAA&password=BBB&type=m3u_plus, the part before /get.php is the server address, and the username and password are right there.

Adding an Xtream Codes login

  1. Open TiviMate. On first launch you'll see Add playlist. If you've used it before, go to Settings > Playlists > Add playlist.
  2. Choose Xtream Codes.
  3. Enter the server address exactly as given, including http:// or https:// and the port number after the colon (for example :8080) if there is one.
  4. Enter the username and password. They're case-sensitive.
  5. Select Next. TiviMate connects and shows how many channels, films and series it found.
  6. Choose which of those to include, give the playlist a short name, and finish.
  1. Go to Add playlist and choose M3U playlist.
  2. Type or paste the full link. Every character matters, including capitals.
  3. Select Next and wait while TiviMate processes it. Large playlists can take a minute.
  4. If your service gave you a separate EPG (TV guide) link, you can add it now or later.
  5. Name the playlist and finish.

If you have the playlist as a file rather than a link (for example a playlist you made yourself), TiviMate can also load it from local storage, but a link is better because it updates when the service changes channels.

An M3U link can be 100 characters of random letters, and the on-screen keyboard is where most mistakes happen. Easier ways:

  • Use your phone as a keyboard. The free Fire TV app (for Fire TV) and Google TV app (for Google TV and Android TV) both have a keyboard that types straight into the TV.
  • Use Xtream details instead if the link contains them. Three short fields are easier than one long one.
  • Avoid link shorteners. Some services send shortened links for convenience. They often break or redirect in ways players don't follow.

When the playlist won't load

Work through these in order:

  1. "0 channels" or "Playlist is empty". Recheck every character, especially the port number and http vs https. Then check your subscription hasn't expired.
  2. Test the link somewhere else. Open the M3U link in VLC on a computer (our VLC guide shows how). If it fails there too, the link or the service is the problem, not TiviMate.
  3. Error 401 or 403. The username, password or account is being refused. Wrong details, an expired account, or too many devices logged in at once.
  4. Error 404. The address is wrong or the service has moved servers. Ask the service for the current details.
  5. Timeouts. The server isn't responding. Try again later, and check other apps on the device can reach the internet.

One more thing to know: some internet providers block known unlicensed IPTV servers, and courts in the UK, Canada and parts of Europe have ordered exactly that. If a service suddenly stops loading everywhere at once, that's a likely reason. We cover where the legal line sits in Is IPTV legal?

Is there a free M3U playlist for TiviMate?

TiviMate comes with no channels, so people often search for a free playlist to put in it. Be careful here. Most "free M3U" lists you'll find on GitHub pages, forums and video descriptions mix a few official streams with channels that are rebroadcast without permission, and the links break within days. There's no way to tell from the list which is which.

The legal free options are better than most people expect:

  • Free TV apps. Pluto TV, Tubi, The Roku Channel, Plex and Samsung TV Plus carry hundreds of free live channels with ads. They work in their own apps rather than as a playlist. Our FAST channel finder shows which service carries a channel you want, and the best free live TV apps covers each one.
  • Your own antenna. A network TV tuner such as an HDHomeRun turns over-the-air channels into a playlist on your home network, which TiviMate can load like any other M3U link. Your local channels, free, with a proper guide.
  • Your own media server. If you run Plex, Jellyfin or Emby with live TV set up, they can serve a playlist to TiviMate too.

If you pay for a legal IPTV service, it will give you its own M3U link or Xtream Codes login, and that's what this guide is for.

Adding a second playlist

If you have more than one service (say, one for live channels and a separate playlist of your own recordings from a home media server), TiviMate can hold several playlists and merge them into one guide. Multiple playlists are a Premium feature, a paid upgrade explained on tivimate.com. Add the second one the same way, through Settings > Playlists > Add playlist. Give each a clear name so you can tell them apart in settings later.

Editing or replacing a playlist later

Services change servers, and passwords get reset. You don't need to delete everything and start again. Go to Settings > Playlists, select the playlist, and edit its URL or login details. Your favourites and hidden groups stay as they were, as long as the channel names don't change.

If you do delete a playlist and re-add it, TiviMate treats the channels as new, so favourites and custom guide matches are lost. Editing is almost always the better option.

After it loads

You should land on TiviMate's TV guide with your channels down the left. If the grid says "No information" instead of programme names, your channels loaded but the guide didn't. That's a separate step: see how to add EPG to TiviMate.

A few settings worth changing on day one:

  • Playlist update interval: in the playlist's settings, set it to update daily, so channel changes come through without you re-adding anything.
  • Hide groups you don't watch: big playlists include dozens of channel groups. Hiding the ones you'll never use makes the guide much faster to scroll.
  • Favourites: long-press a channel to add it to Favourites, then you can open the guide straight to them.

If playback stutters once everything's set up, that's usually your network rather than TiviMate. Our buffering guide has the fixes.

Frequently asked questions

Should I use M3U or Xtream Codes in TiviMate?
Xtream Codes, if your service offers it. It brings the TV guide, films and series along automatically and updates itself. An M3U link works too but often needs a separate EPG link for the guide.
Why does TiviMate say 0 channels?
Usually a typo in the link, a missing port number, an expired account, or the service being down. Test the same link in VLC on a computer. If it fails there too, the problem is the link or the service, not TiviMate.
Is there a free playlist for TiviMate?
Not one we'd recommend. Free M3U lists online mix official streams with unlicensed ones and break quickly. Legal free options are free TV apps like Pluto TV and Tubi, or a playlist from your own antenna tuner such as an HDHomeRun.
Can I add more than one playlist to TiviMate?
Yes, but multiple playlists are a Premium feature. The free version handles one playlist.
How do I type a long M3U link on a Fire TV?
Use the free Fire TV app on your phone, which has a keyboard that types into the TV. On Google TV, the Google TV app on your phone does the same.

Found this useful? Share it.

Written by

IPTVTips Editorial Team

IPTVTips is written and maintained by a small editorial team. We check every guide against official documentation from app developers, device makers and broadcasters, and we update articles when menus, prices or availability change. We only cover legal uses of IPTV.

More from IPTVTips

Add IPTVTips as a preferred source on Google

Comments

Sign in to ask a question or share what worked for you.

Sign in to comment

No comments yet. Questions about a step that didn't work for you are welcome.

Don't stop now