IPTV Stream Checker is a command-line tool designed to check the status of channels in an IPTV M3U8 playlist. It verifies if the streams are alive, captures screenshots, provides detailed information about video and audio streams, and identifies any potential issues like low framerates or mislabeled channels.
![screenshot](https://private-user-images.githubusercontent.com/19603024/358933863-ffa84de1-f644-44b5-9d7d-92e32652a2be.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjU1NzUzMzQsIm5iZiI6MTcyNTU3NTAzNCwicGF0aCI6Ii8xOTYwMzAyNC8zNTg5MzM4NjMtZmZhODRkZTEtZjY0NC00NGI1LTlkN2QtOTJlMzI2NTJhMmJlLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA5MDUlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwOTA1VDIyMjM1NFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTA3ZDA5OWMwOGMwMTQ1N2I0OTRiYjBjMzdiMTg0ZDgyZGIwMjNjZDZlYWNhM2U3YTRmMWRiNjlkYjRmYmViMzQmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.o8VCo8pBXlbZwUOrvP3VKeFAHP_z559_EcM_LuuIbWE)
- Check Stream Status: Verify if IPTV streams are alive or dead.
- Split Playlist: Split into separate playlists for working and dead channels.
- Capture Screenshots: Capture screenshots from live streams.
- Group Filter: Option to check specific groups within the M3U8 playlist.
- Detailed Stream Info: Retrieve and display video codec, resolution, framerate, and audio bitrate.
- Low Framerate Detection: Identifies and lists channels with framerates at 30fps or below.
- Mislabeled Channel Detection: Detects channels with resolutions that do not match their labels (e.g., "1080p" labeled as "4K").
- Custom User-Agent: Uses
IPTVChecker 1.0
as the user agent for HTTP requests.
- Python 3.6+
- ffmpeg and ffprobe: Required for capturing screenshots and retrieving stream information.
git clone https://github.com/NewsGuyTor/IPTVChecker.git
cd IPTVChecker
pip install -r requirements.txt
python IPTV_checker.py /path/to/your/playlist.m3u8
-group
or-g
: Specify a group title to check within the playlist.-timeout
or-t
: Set a timeout in seconds for checking the channel status.-extended
or-e [seconds]
: Enable an extended timeout check for channels detected as dead. If specified without a value, defaults to 10 seconds. This option allows you to retry dead channels with a longer timeout.-split
or-s
: Create separate playlists for working and dead channels.-rename
or-r
: Rename alive channels to include video and audio information in the playlist.-v
: Increase output verbosity toINFO
level.-vv
: Increase output verbosity toDEBUG
level.
-
Standard Check with Default Settings:
python IPTV_checker.py /path/to/your/playlist.m3u8
-
Check a Specific Group:
python IPTV_checker.py /path/to/your/playlist.m3u8 -group "SPORT HD"
-
Check with Extended Timeout:
python IPTV_checker.py /path/to/your/playlist.m3u8 -extended 30
-
Split Playlist into Working and Dead Channels:
python IPTV_checker.py /path/to/your/playlist.m3u8 -split
-
Rename Working Channels with Video and Audio Info:
python IPTV_checker.py /path/to/your/playlist.m3u8 -rename
-
Split Playlist and Rename Working Channels:
python IPTV_checker.py /path/to/your/playlist.m3u8 -split -rename
-
Enable Debug Mode for Detailed Output:
python IPTV_checker.py /path/to/your/playlist.m3u8 -vv
The script will output the status of each channel in the following format:
1/5 ✓ Channel Name | Video: 1080p60 H264 - Audio: 159 kbps AAC
After processing, the script lists any channels with framerates of 30fps or below:
Low Framerate Channels:
1/5 EGGBALL TV HD - 25fps
The script also detects channels with incorrect labels:
Mislabeled Channels:
3/5 Sports5 FHD - Expected 1080p, got 4K
This project is licensed under the MIT License. See the LICENSE file for more details.
Contributions are welcome! Please feel free to submit a Pull Request or open an issue if you have any ideas or feedback.