IPTV Guide Center
IPTV Basics

What Is an M3U Playlist? Complete Beginner's Guide

Published · Updated

M3U playlist file opened in a text editor

An M3U playlist is a simple text file that lists streams. IPTV players read it to build your channel list. Understanding the format makes it easier to fix problems and keep your access secure.

What is inside an M3U file

Each entry has a descriptive line followed by a stream address. A minimal example looks like this: 

#EXTM3U #EXTINF:-1 tvg-id="news1" group-title="News",Example News https://your-provider.example/get.php?username=YOUR_USERNAME&password=YOUR_PASSWORD&type=m3u&output=mpegts

Example only: this address uses a reserved placeholder domain and dummy credentials, so it will not load a real playlist. Your provider may use a URL with a similar format; replace the placeholder domain, username and password with details issued privately by your provider.

The first line identifies the file type. The EXTINF line carries the channel name, group and optional guide ID. The next line is the stream address. Treat a real playlist URL as a password because it may contain account credentials.

A link lets the player download the latest list each time. A file is a static copy on your device or storage.

Annotated M3U entry with the channel name, group and stream address labelled
Each entry has an info line followed by a stream address.

M3U vs Xtream-style login

  • M3U: one URL holds everything.
  • Xtream-style: separate server, username and password that the app uses to request channels and the guide.

Both appear in players like IPTV Smarters and TiviMate.

Side-by-side comparison of an M3U link field and Xtream login fields in a player
A playlist link and an Xtream-style login do the same job.

How to load a playlist

  1. Open your player and choose add playlist.
  2. Select the URL or file option.
  3. Paste or choose your source.
  4. Wait while it imports.
Player add playlist screen with a URL field filled in
Treat your playlist link like a password.

Keep your playlist private

Your link often contains your credentials. Do not post it publicly or share it with people you do not trust.

Common problems

A link with a typo, an expired account or a very large list can load slowly. See the buffering guide and the overview in what IPTV is.

Tip: Open the link in a browser first. A text file or a download means the address is valid.

Frequently asked questions

Is an M3U file a video?

No. It is only a list of addresses that tell a player where to find streams.

Can I edit an M3U file?

Yes, with a text editor, but changes to a hosted link will not save back to the provider.

What does EPG mean?

Electronic programme guide. It is the schedule data that shows what is on each channel.