How to Add M3U Playlist to TiviMate (2026) — M3U, Xtream Codes and Stalker

Quick Answer
Learn how to add an M3U playlist URL to TiviMate in 3 simple steps.
To add M3U playlist TiviMate, you have three options depending on your provider. This add M3U playlist TiviMate guide covers M3U URL, Xtream Codes API, and Stalker Portal setup on Firestick and Android TV.
Adding your IPTV playlist to TiviMate is the first thing you will do after installing the app. Knowing how to add M3U playlist to TiviMate correctly saves hours of frustration after installing the app. The good news is the process takes about two minutes regardless of which method you use. There are three ways to add a playlist depending on the format your IPTV provider supports: M3U URL, Xtream Codes API, or Stalker Portal.
This guide walks through each method step by step, covers how to attach EPG data, and answers the most common questions users run into.
Before You Start: Identify Your Playlist Format
Check the welcome email your IPTV provider sent when you subscribed. It will contain one of three formats. Use this table to identify which one you have:
| What You Received | Format to Use in TiviMate | Best For |
|---|---|---|
A long URL ending in m3u or m3u_plus | M3U Playlist URL | Quick setup, wide compatibility |
| A username, password, and server URL or port | Xtream Codes API | Faster loading, built-in EPG, VOD, catch-up |
| A server address and a MAC address | Stalker Portal | Older providers, MAG-style boxes |
If your provider supports Xtream Codes, choose that method. It loads channels faster, updates EPG more reliably, and provides access to Video on Demand and catch-up TV automatically without extra configuration.
Method 1: Add a Playlist Using an M3U URL
The M3U URL method is the most common way to add IPTV to TiviMate. Your M3U URL will look something like http://provider.com:8080/get.php?username=abc&password=xyz&type=m3u_plus.
- Open TiviMate on your Android TV or Firestick.
- Select Add Playlist on the welcome screen. If you already have a playlist loaded, go to Settings > Playlist > Add Playlist.
- Choose M3U Playlist as the format.
- Paste the full M3U URL into the URL field. Make sure the link starts with
http://orhttps://and includes your credentials. - Give your playlist a name so you can identify it later if you add multiple playlists.
- Click Next and wait for TiviMate to load the channel list. This can take 10 to 30 seconds depending on the number of channels.
Once the playlist loads, TiviMate displays a preview of the channel list so you can verify everything looks correct before finalizing.
Method 2: Add a Playlist Using Xtream Codes API
Xtream Codes is the modern standard for IPTV delivery. It is faster and more reliable than M3U URLs because the server sends structured data instead of a flat text file.
- Open TiviMate and go to Settings > Playlist > Add Playlist.
- Select Xtream Codes API as the format.
- Enter the Server URL or Server IP and Port your provider gave you. The format is usually
http://provider.com:8080. - Enter your Username and Password exactly as provided. These are case-sensitive.
- Select Next. TiviMate connects to the server and retrieves the channel list, EPG data, VOD, and series information automatically.
One major advantage of Xtream Codes is that EPG data is often included in the API response, so you may not need to add a separate EPG source.
Method 3: Add a Playlist Using Stalker Portal
Stalker Portal is an older protocol used primarily by MAG set-top boxes. Some IPTV providers still use it, especially for legacy subscribers.
- Open TiviMate and go to Settings > Playlist > Add Playlist.
- Select Stalker Portal as the format.
- Enter the Portal URL your provider supplied. This typically looks like
http://portal.provider.com/stalker_portal/c/. - If your provider gave you a MAC Address, enter it in the MAC field. The format should be
00:1A:79:XX:XX:XX. - Click Next and allow TiviMate to authenticate with the portal server.
Stalker Portal connections can take slightly longer to authenticate than M3U or Xtream Codes. If the connection times out, double-check the portal URL and MAC address with your provider.
How to Add EPG (Electronic Program Guide) to Your Playlist
EPG data gives you the program schedule for each channel. Without it, you only see channel names with no information about what is currently playing or coming up next.
- Go to Settings > EPG > Add EPG Source in TiviMate.
- Paste the EPG URL your provider sent. This usually ends in
.xmlor.gz. Example:http://provider.com:8080/xmltv.php?username=abc&password=xyz. - Assign the EPG source to your playlist. TiviMate asks you which playlist this EPG belongs to if you have multiple playlists.
- Wait for the EPG data to download. Large providers with hundreds of channels may take 30 to 60 seconds to fully load.
- Go back to the main screen and check a few channels to confirm the program guide appears.
If you used the Xtream Codes API method, check whether EPG data loaded automatically before adding a separate EPG source.
How Many Playlists Can You Add?
The free version of TiviMate supports one playlist. If you need more than one, you need the Premium version, which supports unlimited playlists on up to five devices. This is useful if you subscribe to multiple IPTV services or want to separate live TV from VOD content into different playlists.
Troubleshooting Common Playlist Issues
| Problem | Likely Cause | Fix |
|---|---|---|
| Playlist loads but no channels appear | Wrong URL or expired account | Check your subscription status with your provider and verify the URL is correct |
| M3U URL returns error or blank screen | URL contains special characters that need encoding | Try wrapping the URL in double quotes, or ask your provider for a new link |
| Xtream Codes connection fails | Incorrect server address or port | Verify the server URL and port number with your provider; try using port 8080 |
| Stalker Portal times out | MAC address is wrong or blocked | Confirm your MAC address with your provider and ask them to reset the portal connection |
| EPG shows no data | EPG source not assigned to playlist | Go to EPG settings and make sure the EPG source is linked to the correct playlist |
| Channels buffer during playback | Internet speed or server load | Test with a wired Ethernet connection or use a VPN to bypass ISP throttling |
FAQs About Adding Playlists to TiviMate
Where do I get an M3U playlist URL?
Your IPTV provider sends the M3U URL in the welcome email after you subscribe. If you cannot find it, contact your provider’s support team and ask them to resend your playlist details.
What is the difference between M3U and Xtream Codes?
M3U is a plain text file format that lists channel URLs. Xtream Codes is an API that provides structured data including channel names, EPG, VOD, and series categories. Xtream Codes loads faster and requires less manual setup.
Can I use both M3U and Xtream Codes at the same time?
Yes. With the Premium version you can mix playlist formats. You might have one provider using M3U and another using Xtream Codes, both active in the same TiviMate installation.
Does TiviMate support XML EPG sources?
Yes. You can add any XMLTV EPG source including gzip-compressed files. Just paste the URL into the EPG settings and assign it to the corresponding playlist.
How do I switch between multiple playlists?
Open the side menu in TiviMate and select the playlist name at the top. A dropdown shows all your active playlists so you can switch between them instantly.
Can I rearrange channel order in TiviMate?
Yes. Go to Settings > Playlist > Manage Groups to reorder channel groups. You can also hide groups you do not watch by selecting the eye icon next to each group.
What happens to my playlists if I uninstall TiviMate?
Playlists are stored locally on your device. Uninstalling TiviMate removes all playlists and settings. Make a note of your playlist URLs and EPG sources before uninstalling so you can re-enter them later.
Next Steps After Adding Your Playlist
Once your playlist is loaded and EPG is working, you can customize your experience. Learn how to install TiviMate on other Android TV devices or set up the TiviMate Companion app to use your phone as a remote. If you run into the Error 458 connection limit, there is a dedicated guide for that too.
M3U format on Wikipedia. For more information, visit the Ookla Speedtest.
About the Author
Written by
TiviMate TeamExperienced IPTV enthusiast and tech writer covering Android TV, Firestick, and streaming technology. Helping viewers cut the cord since 2020.
Ready to Download TiviMate?
Get TiviMate free and start streaming in minutes. Used by 500K+ streamers worldwide.
Download TiviMate Free →Free download | No credit card required | Android TV & Firestick