Open-source · Python · Local-first

Check an IPTV M3U playlist in your browser.

Use this online IPTV M3U playlist checker to inspect M3U and M3U8 file structure in your browser. Find malformed EXTINF entries, missing media URLs and duplicates without uploading your file. This tool checks playlist structure only; it does not test stream playback or verify an IPTV provider.

Requires Python 3.9 or newer · MIT License

playlist report

$ python3 m3u_inspector.py playlist.m3u

M3U Playlist Inspector

File: playlist.m3u

24Entries
0Errors
2Warnings

WARNING Line 18: Duplicate media URL

✓ Report completed locally

100% localYour playlist stays on your device
Zero dependenciesUses the Python standard library
JSON + CSVExport reports for your workflow

Try it in your browser

Check an M3U playlist online, right in your browser.

Paste an M3U playlist or choose a local .m3u or .m3u8 file. The online validator checks its structure in this browser tab; your playlist is not uploaded.

Privacy: the file is read locally by your browser. Do not paste playlists containing credentials on a shared computer.

Create a playlist in your browser

Build an M3U playlist and download your file.

Create an M3U playlist by adding entries and media URLs you own or are authorized to use. The M3U playlist generator builds and downloads your file locally in this browser; nothing is uploaded.

Add at least one entry to create your M3U file.

0 entries added
0Groups
0With logos
0With TVG ID

Playlist validation

Checks playlist structure locally. It never contacts media URLs.

0 errors0 warnings0 passed
  • Add entries to validate your playlist.

Safe fixes trim whitespace and normalize invalid durations to -1. Duplicate removal requires confirmation. Invalid URLs are reported, never tested or silently removed.

Sort A–Z reorders the entire playlist. Undo restores the previous playlist state for one change.

Shortcuts: ⌘ / Ctrl + Z Undo · ⌘ / Ctrl + S Download playlist · / Search · ⌥ / Alt + ↑ / ↓ Move focused entry · Drag entries to reorder

Select entries to apply bulk changes.

Duplicate scan checks repeated media URL text in this playlist.

This creates a basic extended M3U text file. It does not test URLs, guarantee playback, validate HLS streams or verify content rights. Use only media sources you are authorized to use.

Create an M3U playlist with the online generator

Use this M3U playlist generator to make a playlist from entries you are authorized to use. Add a channel or media name and its URL, then include optional group, TVG ID and logo details. Import an existing M3U file to continue editing it, organize entries, check for repeated URLs and download the result as an .m3u file.

Looking for an M3U playlist maker? This browser-based tool creates the playlist text on your device. It does not host streams, check whether a media URL is active or confirm that a playlist will play in a particular app.

Need to edit or organize an existing M3U playlist? Read the M3U editor guide → · Learn how to create an M3U playlist →

What it checks

Understand playlist structure at a glance.

Catch common formatting issues before passing a playlist to another tool or workflow.

01

Header and entries

Check the extended M3U header and find entries that are missing media URLs or metadata.

02

EXTINF syntax

Flag missing separators and invalid or non-finite duration values in EXTINF records.

03

Duplicate locations

Identify repeated media URLs and see the line where the duplicate appears.

04

Useful reports

Export structured JSON or CSV issue reports, or display parsed entry names in the terminal.

Get started

Run your first playlist check.

Download the source, open a terminal in the project folder and run the inspector with a local playlist path.

TerminalPython 3.9+
# Clone the repository
git clone https://github.com/drxalan32/m3u-playlist-inspector.git
cd m3u-playlist-inspector

# Inspect a local playlist
python3 m3u_inspector.py path/to/playlist.m3u

# Export JSON and CSV reports
python3 m3u_inspector.py path/to/playlist.m3u --json report.json --csv report.csv

# Display parsed entries
python3 m3u_inspector.py path/to/playlist.m3u --show-entries

Learn and troubleshoot

Practical M3U playlist guides.

Looking for a specific utility? Explore all M3U playlist tools in one place →

Understand playlist structure and learn how to check common formatting problems locally.

GUIDE

How to validate an M3U playlist

A step-by-step Python guide covering EXTINF records, missing locations and report exports.

Read the guide →
EXAMPLES

M3U playlist examples

See simple and extended M3U examples with EXTINF entries, groups and optional TVG metadata.

View M3U examples →
ORGANIZE

How to organize an M3U playlist

Learn to use consistent channel names, group-title categories and accurate optional metadata.

Read the organization guide →
EDIT

M3U playlist editor online

Import a playlist, edit entry details, reorder or delete items, and download your updated M3U file locally.

Open the M3U editor guide →
MERGE

M3U playlist merger

Combine multiple M3U or M3U8 files, remove duplicate stream URLs and download one merged playlist in your browser.

Merge M3U playlists →
ANALYSE

M3U playlist analyzer

Review entry counts, duplicate URLs, categories, missing metadata and URL protocols with a local browser-based report.

Analyse an M3U playlist →
CONVERT

M3U playlist converter

Convert M3U playlists to CSV or JSON, or turn supported CSV and JSON channel data back into M3U.

Convert playlist files →
FORMAT

What is an M3U file? Format and structure

Learn what an M3U playlist file contains, how EXTINF and EXTM3U tags work, and how to spot common formatting issues.

Read the M3U file format guide →
COMPARE

M3U vs M3U8: What is the difference?

Understand encoding, file extensions and how the two playlist names are used.

Read the comparison →
TROUBLESHOOT

Why is my M3U playlist not working?

Learn how to diagnose common playlist formatting issues and understand what a local checker can and cannot detect.

Read the troubleshooting guide →

Know the format

What is an M3U8 playlist?

M3U is a text-based playlist format. Extended M3U files commonly begin with #EXTM3U and use #EXTINF lines to describe media entries. M3U8 is commonly used for UTF-8 encoded playlist text.

Explore the M3U and M3U8 format guide →

Browse practical M3U playlist examples →

Learn how to create an M3U playlist file step by step →

#EXTM3U
#EXTINF:-1,Example entry
https://example.com/media/example.m3u8

FAQ

Frequently asked questions.

Does the inspector test whether a stream is online?

No. It checks local playlist structure only. It does not connect to media URLs, test playback or verify availability.

Are playlist contents uploaded anywhere?

No. The command-line tool reads the file locally and does not send playlist contents to an external service. Keep private URLs and credentials out of public bug reports.

Do I need to install Python packages?

No third-party packages are required. The project uses the Python standard library and requires Python 3.9 or newer.

Does a clean report prove that a playlist is safe or licensed?

No. A structural check does not verify ownership, licensing, security or whether media can be played. Only inspect playlists you own or are authorized to use.

Open source

Inspect your playlist with confidence.

Try the browser-based checker, explore the source code or read the documentation.

Try the online checker ↓