Header and entries
Check the extended M3U header and find entries that are missing media URLs or metadata.
Open-source · Python · Local-first
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
$ python3 m3u_inspector.py playlist.m3u
M3U Playlist Inspector
File: playlist.m3u
WARNING Line 18: Duplicate media URL
✓ Report completed locally
Try it 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.
No structural issues were found by these checks. This does not verify playback, availability, safety or content rights.
This is a basic structural check, not a complete HLS validator. It does not connect to media URLs or verify whether content is licensed.
Create a playlist in your browser
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.
Checks playlist structure locally. It never contacts media URLs.
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.
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
Catch common formatting issues before passing a playlist to another tool or workflow.
Check the extended M3U header and find entries that are missing media URLs or metadata.
Flag missing separators and invalid or non-finite duration values in EXTINF records.
Identify repeated media URLs and see the line where the duplicate appears.
Export structured JSON or CSV issue reports, or display parsed entry names in the terminal.
Get started
Download the source, open a terminal in the project folder and run the inspector with a local playlist path.
# 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
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.
A step-by-step Python guide covering EXTINF records, missing locations and report exports.
Read the guide →See simple and extended M3U examples with EXTINF entries, groups and optional TVG metadata.
View M3U examples →Learn to use consistent channel names, group-title categories and accurate optional metadata.
Read the organization guide →Import a playlist, edit entry details, reorder or delete items, and download your updated M3U file locally.
Open the M3U editor guide →Combine multiple M3U or M3U8 files, remove duplicate stream URLs and download one merged playlist in your browser.
Merge M3U playlists →Review entry counts, duplicate URLs, categories, missing metadata and URL protocols with a local browser-based report.
Analyse an M3U playlist →Convert M3U playlists to CSV or JSON, or turn supported CSV and JSON channel data back into M3U.
Convert playlist files →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 →Understand encoding, file extensions and how the two playlist names are used.
Read the comparison →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
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.
#EXTM3U
#EXTINF:-1,Example entry
https://example.com/media/example.m3u8
FAQ
No. It checks local playlist structure only. It does not connect to media URLs, test playback or verify availability.
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.
No third-party packages are required. The project uses the Python standard library and requires Python 3.9 or newer.
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
Try the browser-based checker, explore the source code or read the documentation.
Try the online checker ↓