Skip to content
FreeIPTV.codes
IPTV Playlists

How to Add an IPTV Playlist to a Player

Editorial Team8 min readReviewed Sep 19, 2026
IPTV player open network stream dialog with M3U URL being pasted
IPTV player open network stream dialog with M3U URL being pasted

Adding an IPTV playlist to a player requires two things: your M3U URL (from your provider) and a compatible player app installed on your device. The process takes under two minutes in any modern IPTV player. The steps below cover the most widely used apps.

What You Need Before You Start

  • Your M3U URL — a link that looks like https://provider.example/get.php?username=you&password=xxx&type=m3u_plus. Your provider sends this in a welcome email or account dashboard.
  • A compatible player — VLC, TiviMate, IPTV Smarters Pro, or Smart IPTV depending on your device.
  • Internet connection — the player fetches the playlist and streams over your network.

If you have a downloaded .m3u or .m3u8 file rather than a URL, the steps are the same — just use "open file" instead of "open URL" where noted.

Before loading into a live player, run your M3U URL through the IPTV Free Trial Checker to confirm the playlist parses correctly and check for missing headers or insecure stream URLs.

Choose the Right Input Field

Most setup failures happen because the right value goes into the wrong field:

You havePut it inDo not put it in
M3U URLPlaylist / M3U URL fieldXtream server field
Xtream server + username + passwordXtream Codes/API loginM3U URL field
XMLTV/EPG URLEPG / TV guide fieldPlaylist field
Downloaded .m3u fileOpen file / upload fileNetwork URL field

If your provider message includes get.php?username=...&password=...&type=m3u_plus, it is normally an M3U URL. If it gives three separate values — server, username, password — use the Xtream login option.

How to Add a Playlist in VLC

VLC is available for Windows, macOS, Linux, Android, and iOS.

  1. Open VLC.
  2. Go to Media → Open Network Stream (Windows/Linux) or File → Open Network… (macOS).
  3. Paste your M3U URL into the URL field.
  4. Click Play.

VLC loads the playlist and starts playing the first stream. To browse channels, open the Playlist panel: View → Playlist (or press Ctrl+L on Windows).

For a downloaded file: Media → Open File → select your .m3u or .m3u8 file.

VLC does not include a full EPG guide. It is best for quick testing and desktop viewing. For a living-room EPG experience on Android TV or Firestick, TiviMate or IPTV Smarters are more suitable.

How to Add a Playlist in TiviMate

TiviMate runs on Android TV and Firestick. The free version supports one playlist; TiviMate Premium unlocks multiple playlists and EPG features.

  1. Open TiviMate.
  2. On first launch, tap Add playlist on the welcome screen. If already set up: Settings → Playlists → Add playlist.
  3. Choose M3U playlist.
  4. Select Enter URL, paste your M3U URL, then tap Next.
  5. Give the playlist a name (e.g. your provider's name) and tap Add.

TiviMate downloads the playlist and builds the channel list. To add EPG:

  1. Go to Settings → EPG sources → Add EPG source.
  2. Paste your provider's XMLTV URL.
  3. Tap Save.

After adding the playlist, test one channel before arranging favourites. If no channels appear, check whether the playlist URL opens in a browser and starts with #EXTM3U.

How to Add a Playlist in IPTV Smarters Pro

IPTV Smarters Pro is available on Android, iOS, Android TV, and Firestick.

  1. Open IPTV Smarters Pro.
  2. On the home screen, tap Add New User.
  3. Select Load Your Playlist or File/URL.
  4. Enter a name for the playlist (e.g. your provider).
  5. Paste your M3U URL into the Playlist URL field.
  6. (Optional) Paste your XMLTV URL into the EPG URL field.
  7. Tap Add User.

The app downloads the playlist and displays your channel categories. If your provider uses Xtream Codes API credentials instead of an M3U URL, select Xtream Codes API on step 3 and enter your server, username, and password.

If login fails, check the portal/server URL format first. Some providers expect the full http://host:port value; others document only host:port. Copy the exact format from the provider panel before trying variants.

How to Add a Playlist on a Smart TV

Smart TVs (Samsung Tizen, LG webOS) do not run TiviMate or IPTV Smarters natively. The most compatible option is Smart IPTV (SIPTV), available from the TV's app store.

  1. Install Smart IPTV from your TV's app store.
  2. Note the MAC address displayed on screen (format: XX:XX:XX:XX:XX:XX).
  3. On a computer, go to siptv.eu and enter your MAC address.
  4. Paste your M3U URL into the playlist field and save.
  5. Restart the Smart IPTV app on your TV.

The playlist is loaded remotely via the MAC-to-URL mapping. This approach does not require typing a URL on the TV keyboard.

First-Run Test After Adding a Playlist

Once the player imports channels:

  1. Open one channel in a common category such as News.
  2. Wait 30-60 seconds to check for immediate freezing.
  3. Switch to another category.
  4. Add the EPG URL and refresh the guide.
  5. Restart the app and confirm the playlist still appears.

Do this before you spend time building favourites. If the profile fails after restart, the app may not have saved the URL correctly.

What to Do If the Playlist Does Not Load

If you add the URL and the player shows an error or empty channel list:

  • Check the URL — copy it into a browser and confirm it returns a text file starting with #EXTM3U, not an HTML login page.
  • Check your credentials — if the URL contains username= and password=, confirm they are correct and the trial has not expired.
  • Try a different player — some players are stricter about encoding or Content-Type headers. If VLC loads the list but TiviMate does not, check the player's URL settings for an "allow insecure" or "force UTF-8" option.
  • Run the checker — paste the URL into the Free Trial Checker to get a detailed error report.
  • Check the EPG separately — a blank guide does not always mean the playlist failed. Test the XMLTV URL on its own.
  • Watch for spaces — copied credentials often include a trailing space, especially on TV keyboards.

Full troubleshooting steps are in IPTV Playlist Not Working.

When to Remove and Re-Add a Playlist

Do not delete the profile for every small issue. Use this order:

SituationBest action
New channels missingRefresh playlist first
EPG blankRefresh EPG, not playlist
URL changed by providerEdit playlist URL or re-add profile
App saved wrong credentialsDelete and re-add
Old cache keeps returningClear app cache; clear data only as a last step

Deleting a profile can remove favourites, groups and guide settings. Refresh first, delete only when the saved login itself is wrong.

FAQ

Can I add the same playlist to multiple players?

Yes. An M3U URL is just a link. You can paste it into as many players as you like. Whether your provider allows simultaneous streams on one account depends on their subscription terms.

Do I need to re-add the playlist after updating it?

No. Players fetch the playlist fresh each time they start (or on a configured refresh interval). If your provider updates the stream URLs, the next playlist fetch will pick up the changes automatically — you do not need to remove and re-add the playlist.

What is the difference between an M3U URL and Xtream Codes?

An M3U URL returns a plain-text playlist file. Xtream Codes is an API that lets players fetch channels, VOD, and series separately and supports features like catch-up TV. Both are ways to access IPTV content — which one your provider offers is in their account dashboard.

Can I use a downloaded .m3u file instead of a URL?

Yes. In every player, there is an "open file" option alongside "open URL". Download the .m3u or .m3u8 file from your provider, save it to your device, and use the file import option. The main drawback is that a downloaded file does not auto-update — you have to re-download manually when the provider updates stream URLs.

Should I add the EPG before or after the playlist?

Add the playlist first so the player has channels to match. Then add the EPG/XMLTV URL and refresh the guide.

Why does the playlist work in VLC but not my TV app?

VLC is more permissive than many TV apps. If VLC works, check the TV app's login type, HTTPS support, playlist size, and codec/device limits.


Next steps: Learn how the playlist works under the hood in How Do IPTV Playlists Work?, or see player-specific guides in the IPTV Players section.