RunTV / Free IPTV tools / M3U playlist checker

M3U playlist checker

Check any M3U or M3U8 playlist in seconds: channel count, groups, duplicates, broken lines, EPG link and catch-up. It runs on your device, so your playlist is never uploaded.

Quick answer: an M3U playlist is a text file. Each channel is a #EXTINF line with its name, followed by the stream address on the next line.

A playlist breaks when that pattern breaks: a channel line with no address, an address with no channel line, or a file that isn't really M3U (often an error page from the provider).

For a TV guide (EPG) a playlist needs an EPG link in its first line (url-tvg) and a tvg-id on each channel that matches the guide.

Check a playlist
Open the playlist file, or paste its text. Nothing is uploaded: the check runs in this browser.
.m3u, .m3u8 or .txt

Only have a link? Paste it and this browser tries to load it straight from its address, never through RunTV. Most IPTV links can't be read by a web page (plain http, or the server doesn't allow it). If that happens, open the link in your browser to save the file, then open the file here.

What the checker looks at

Is it really M3U?

A real playlist starts with #EXTM3U. If the file is an HTML page, JSON or an error message, the provider's link didn't return a playlist. That usually means the subscription has ended, the login changed, or the link is the wrong type.

Channels and groups

Counts every channel and the group-title groups they sit in, and splits live channels from movies and series where the addresses show it.

Broken lines

A channel line with no stream address under it, an address with no channel line, or a channel with no name. Most players skip these, some refuse the whole file.

Duplicates

The same stream address listed twice, or the same channel name twice in one group. Harmless, but it makes long lists harder to use.

EPG (TV guide)

Whether the playlist names a guide (url-tvg or x-tvg-url) and how many channels carry a tvg-id, which is what matches a channel to its guide.

Catch-up

Whether channels carry catch-up tags (catchup, catchup-days, timeshift). Catch-up still depends on your provider and your player supporting it.

Common problems and fixes

Questions

What is an M3U playlist?
An M3U playlist is a text file that lists TV channels or videos. Each entry is an #EXTINF line with the channel name and details, followed by the stream address on the next line. M3U8 is the same format saved as UTF-8 text.
Why won't my M3U playlist load?
Most often the link didn't return a playlist at all because the subscription has ended or the login changed, so the provider sends an error, an empty reply or an expired message instead. Other causes are a file cut off while saving, channel lines with no stream address, or a list so large that the device is slow to read it.
How do I get a TV guide (EPG) with an M3U playlist?
The playlist needs a guide link in its first line (url-tvg or x-tvg-url) and a tvg-id on each channel that matches the guide. If the playlist has no guide link, ask your provider for their XMLTV link and add it in your player's EPG settings.
What does catch-up mean in an M3U playlist?
Catch-up tags such as catchup, catchup-days or timeshift mark channels where you can watch shows that already aired. The tags only describe what the provider offers. Your provider and your player both have to support catch-up for it to work.
Is my playlist uploaded when I check it?
No. The file or text is read and checked inside your browser. Nothing is uploaded, saved or sent to RunTV, and stream addresses, which often contain your login, are never shown on screen. If you paste a link, your browser loads it straight from that address, the same way a player would, and it never passes through RunTV.
What is the difference between M3U and Xtream Codes?
M3U is a single playlist link or file. Xtream Codes is a login with a server address, username and password, which lets a player load channels, movies, series, the guide and catch-up from the provider directly. Many providers offer both.

More free tools and guides