How to Add an M3U Playlist on Android TV, Google TV and Fire TV
· Setup · 5 min read
The mechanics are the same on Android TV, Google TV and Fire TV, because all three run Android underneath. What differs is how you install the player and how you get a long URL into a text field without losing your temper.
This walkthrough uses Xtiva, which we build. Every player follows the same shape, so the steps translate.
Before you start
Have three things ready.
Your source. Either an M3U URL, or an Xtream Codes server address, username and password. If you have one and want the other, the conversion is straightforward.
A way to type. This is the step people underestimate. An M3U URL is often 80 characters of mixed case and punctuation, and entering it with a directional pad on an on-screen keyboard is genuinely miserable. Two better options:
- Your phone as the remote. The Google TV app on Android and iOS, or the Fire TV app, gives you the television's text field on your phone keyboard. This is the fastest route and needs no hardware.
- A Bluetooth keyboard. Pair it under the device's Bluetooth settings. Worth it if you set up televisions often.
A wired connection, if you can. Not required, but it removes one variable from any problem that appears later.
Step 1 — Install the player
On Android TV and Google TV, open the Play Store on the device, search for the player by name, and install. Xtiva is on Google Play and appears in the television store on Android 6.0 and above.
On Fire TV, the Amazon Appstore carries a smaller selection, so many players are installed with the Downloader app instead. That process has its own steps and a few things worth knowing about Amazon's device settings — it is covered in the Fire TV Stick walkthrough.
On a generic Android box — the MXQ, MECOOL and similar boxes common outside North America and western Europe — you will usually have the Play Store. If not, the box's own app store or a sideload works the same way. Be aware that many of these boxes ship with an outdated Android version and modest memory, which matters later.
Step 2 — Open the player and choose your connection method
On first launch a player that ships correctly is empty. Xtiva shows an add-source screen and nothing else, because there is nothing else to show — it comes with no channels, playlists or streams of any kind.
You will be offered a choice between an Xtream Codes login and an M3U playlist. If your provider supports Xtream Codes, take it — it loads faster and brings the guide with it.
Step 3a — Adding Xtream Codes
Three fields:
Server URL. The scheme, host and port only: http://server.example:8080. Nothing after the port. Pasting a full get.php?username=… URL here is the most common setup failure there is, and it reports back as a credentials error rather than as the address problem it is.
Username and password. Exactly as issued, case-sensitive. Watch for a trailing space if you pasted them.
Give the source a name you will recognise if you later add a second, and save. The player authenticates, pulls the category list, and you should reach a channel list within a few seconds.
Step 3b — Adding an M3U playlist
As a URL — the option you want. Paste the full playlist URL, including get.php and its parameters. Name it, save it, and wait: unlike Xtream Codes, the whole file downloads and parses before anything appears. Thirty seconds is normal for a large catalogue. Several minutes on a slow box is not a fault.
As a local file — available in most players, and a snapshot. It will not follow your provider's changes and will go stale. Use it only when you have no URL.
Step 4 — Add the programme guide, if it did not arrive
With Xtream Codes the guide usually appears on its own. With M3U it often does not, because the guide is a separate XMLTV file.
Find the EPG or guide section of the player's settings and add the XMLTV URL your provider supplied. Then leave it — the first download can take a few minutes, and a guide covering seven days across several thousand channels is a large file.
If the guide loads but sits against the wrong channels, or every programme is shifted by a fixed number of hours, that is a known and fixable class of problem: see the EPG guide.
Step 5 — Make it usable
Worth ten minutes now.
Mark favourites. A provider list of several thousand channels is unusable as delivered. Twenty favourites is the difference between an app you open and one you avoid.
Hide categories you will never watch. Most players allow it. Fewer categories means faster navigation and a faster launch.
Set the guide's timezone. If the offset is wrong every programme time is wrong, and it is a one-time fix.
Check the decoder. Play a channel and let it run a minute. If it stutters on a connection you know is fast, or plays with no sound, the decoder is the suspect and switching engines usually settles it — the codec and audio guide explains which way to switch.
If something did not work
Nothing loaded at all. Check the server address first, then the scheme, then the port — the login troubleshooting guide works through them in order. Confirm the device has internet by opening something else.
A category list appeared but is empty. The playlist parsed and the server returned nothing. That points at the account: expired, or at its connection limit because another device is streaming.
Channels listed but none play. The list came from the API and the video did not. Try a second channel — one dead channel is the provider's problem. If none play, switch playback engine before anything else.
Everything works but stutters. Start with the buffering guide, which separates the network causes from the device ones.
A note on sources
We do not supply, sell or recommend IPTV services, and we do not link to playlists. Xtiva is a player: you bring the provider, and you are responsible for the legality of the service you connect to. What an IPTV player is covers where that line sits and how to judge a provider.
Setting up on a Fire TV Stick specifically? That walkthrough is here.
Common questions
How do I type a long M3U URL with a TV remote?
Do not type it. Use your phone as a remote — the Google TV or Fire TV app turns your phone keyboard into the television's input — or pair a Bluetooth keyboard. Both take a minute to set up and save far more than that, with fewer mistakes.
My playlist loaded but no channels appear. What now?
Usually a connection limit or an expired account rather than a fault in the player. Check whether another device is streaming, then confirm the account is active. If a category list appeared but is empty, the playlist parsed correctly and the server returned nothing, which points at the account.
Can I add more than one playlist?
In a player that supports it, yes. Xtiva allows several Xtream Codes accounts and M3U playlists side by side with switching inside the app, which is worth having if you keep separate sources.
Does the playlist update by itself?
If you added it as a URL, yes — the player refetches it and picks up your provider's changes. A file imported from local storage is a snapshot and goes stale. Prefer the URL whenever you have one.