How free-tv/iptv works
Free TV is a worldwide catalog of free-to-watch television streams, distributed as M3U playlists. The main user workflow is to select a country playlist and open it in a compatible player. Markdown channel lists are also checked for availability: the checker probes streams, classifies results, and records run history; a dashboard generator turns that history into a status page. The map reflects documented behavior and sampled source; checker internals and some runtime wiring were not fully excerpted.
Main entry points: make_playlist.py M3U Generator · check_channels.py Channel Checker · playlist.m3u8 Combined Playlist · playlists Country Playlists
Components 13
Channel Catalog
- Channel Lists
lists - EPG Sources
epglist.txt
Playlist Delivery
- M3U Generator
make_playlist.py - Combined Playlist
playlist.m3u8 - Country Playlists
playlists
Stream Monitoring
- Channel Checker
check_channels.py - Check History
.github/checker-history/history.jsonl
Status Reporting
- Dashboard Generator
generate_dashboard.py - Status Dashboard
Other components
- Playlist User
- M3U Player
- Stream Hosts
- ffprobe
Connections 14
- Playlist User → Country Playlists: selects
README.md - Playlist User → Combined Playlist: selects
README.md - M3U Generator → Channel Lists: reads
make_playlist.py - M3U Generator → EPG Sources: reads
make_playlist.py - M3U Generator → Combined Playlist: writes
make_playlist.py - M3U Generator → Country Playlists: writes
make_playlist.py - Country Playlists → M3U Player: opens in
- Combined Playlist → M3U Player: opens in
- Channel Checker → Channel Lists: reads
check_channels.py - Channel Checker → Stream Hosts: probes
check_channels.py - Channel Checker → ffprobe: confirms dead
check_channels.py - Channel Checker → Check History: appends results
check_channels.py - Dashboard Generator → Check History: reads
generate_dashboard.py - Dashboard Generator → Status Dashboard: generates
generate_dashboard.py