iptv-toolkit
A free command-line tool to inspect, check, clean and merge M3U / M3U8 playlists, and to measure the real speed you get from a stream. Zero dependencies, runs anywhere Python 3.8+ runs.
$ pip install git+https://github.com/smartvpro-tv/iptv-toolkit.git
$ iptv-toolkit --version
iptv-toolkit 1.0.0What it does
| Command | What you get |
|---|---|
info | Number of channels and groups, duplicate URLs, entries with no EPG id or logo, EPG source. |
check | Tests every stream in parallel. Marks each one OK, DEAD, TIMEOUT or ERROR and can save a playlist with only the working ones. |
clean | Removes duplicate URLs and sorts by name or group. |
merge | Combines several playlists into one, without duplicates. |
filter | Keeps or drops channels by group or by a name pattern. |
speed | Downloads from one stream for a few seconds and tells you if your line can play SD, HD, Full HD or 4K. |
Why test speed to the stream?
A normal speed test measures your line to a test server close to you. That number can look great while a channel still buffers, because the path to the stream server is different, busier, or throttled. iptv-toolkit speed downloads real video segments from the stream itself, so the result matches what your player sees.
$ iptv-toolkit speed "http://your-provider.example/live/channel/index.m3u8"
Throughput : 17.1 Mbps
Result: this connection can play Full HD (1080p) smoothly.Guides
Getting startedInstall on Windows, macOS, Linux or Android and run your first check.
Fix bufferingFind out if the problem is your Wi-Fi, your internet line or the stream.
The M3U formatWhat every line of a playlist means: EXTINF, tvg-id, group-title, EPG.
Guides by country
🇺🇸 USATest your playlist and line before and after you subscribe.
🇬🇧 United KingdomSpeed targets for HD and 4K, and Premier League evenings.
🇨🇦 CanadaChecks for Canadian lines, from Toronto to Vancouver.
🇳🇱 NederlandJe IPTV-playlist en verbinding testen, in het Nederlands.
iptv-toolkit does not include, find or share any channels or playlists. Use it with playlists you are allowed to use, such as the one from your own provider.