a86fb23e94
Builds on the idea in #1145 (a checker that maps failures back to a channel and list, and tells a geo-blocked channel from a dead one) with a few additions: check_channels.py - Standard library only, same as #1145's version. - Adds a `disputed` state: an optional --confirm-dead pass gives ffprobe a second opinion on anything that looks dead over HTTP, before it gets reported as dead. This is one-directional (can only pull a verdict out of `dead`, never push one into it) because ffprobe itself is not reliable enough to trust in the other direction - a known-good DASH channel needed longer than any sane per-channel budget to open while testing this, and a header check alone had already been fooled by an isolated media fragment sitting at a URL that looked like a live channel (a mistake made and caught while triaging #1149/#1151 - see the docstring for the details). - Restructured to share one worker pool across every list in a run instead of a fresh pool per list, which stopped small lists from paying the same wall-clock floor as large ones; a full run across all lists dropped from not finishing in 15 minutes to about 10. - --json writes one record per channel per run, for building a history. generate_dashboard.py - Turns that history into a single self-contained docs/index.html: current state breakdown, an alive-share trend across every run kept, a per-list breakdown, and a searchable/filterable table of everything that is not currently alive. Two new scheduled workflows - check_channels_fast.yml: every 6 hours, HTTP checks only. - check_channels_deep.yml: every 2 days, with --confirm-dead (needs ffmpeg). Both append to .github/checker-history/history.jsonl (pruned to 90 days), then build and deploy the dashboard to GitHub Pages. |
||
|---|---|---|
| .github | ||
| lists | ||
| playlists | ||
| .gitignore | ||
| README.md | ||
| check_channels.py | ||
| epglist.txt | ||
| flag_order.txt | ||
| generate_dashboard.py | ||
| make_flags.sh | ||
| make_playlist.py | ||
| playlist.m3u8 | ||
README.md
Free TV
This is an M3U playlist for free TV channels around the World.
Either free locally (over the air):
Or free on the Internet:
- Plex TV
- Pluto TV (English, Spanish, French, Italian)
- Redbox Live TV
- Roku TV
- Samsung TV Plus
- Youtube live channels
To use it point your IPTV player to https://raw.githubusercontent.com/Free-TV/IPTV/master/playlist.m3u8.
Philosophy
The main goals for this playlist are listed below.
Quality over quantity
The less channels we support the better.
- All channels should work well.
- As much as possible channels should be in HD, not SD.
- Only one URL per channel (no +1, no alternate feeds, no regional declinations)
Only free channels
If a channel is normally only available via commercial subscriptions it has nothing to do in this playlist. If on the other hand it is provided for free to everybody in a particular country, then it should be in this playlist.
- No paid channels
- Only channels which are officially provided for free (via DVB-S, DVB-T, analog, etc..)
Only mainstream channels
This is a playlist for everybody.
- No adult channels
- No channels dedicated to any particular religion
- No channels dedicated to any particular political party
- No channels made for a country and funded by a different country
Feed sources
It can be quite hard to find up to date URLs, here's a list of sources:
- https://github.com/iptv-org/iptv/tree/master/streams
- Youtube: As long as the channel is live and its URL doesn't change (check the age of the stream, the number of viewers..)
- Dailymotion: Same criteria as for youtube
Format
The m3u8 playlist is generated by make_playlist.py, using the .md files located in lists.
Each .md file represents a group. The <h1> line is used as the group title.
Only channels which URL column starts with [>] are included in the playlist.
Channels which are not in HD are marked with an Ⓢ.
Channels which use GeoIP blocking are marked with a Ⓖ.
Channels which are live Youtube channels are marked with a Ⓨ.
Issues
Only create issues for bugs and feature requests.
Do not create issues to add/edit or to remove channels. If you want to add/edit/remove channels, create a pull request directly.
Pull Requests
Only modify .md files
If your Pull Request modifies channels, only modify .md files. Do not modify m3u8 files in your pull request.
Adding a new Channel
To add a new channel, make a Pull Request.
- In your Pull Request you need to provide information to show that the channel is free.
- Use imgur.com to host the channel logo and point to it.
- If you have a valid stream, add it and put
[>]in front of it. - If you don't have an stream for the channel, add
[x]()in the url column and place your channel in the Invalid category. - If you have a stream but it doesn't work well, put the channel in the Invalid category and put
[x]in front of the url. - If you're adding geoblocked URLs specify it in your PR and specify which country they're working in. The PR will only be merged if these URLs can be tested.
Removing a Channel
To remove a channel, make a Pull Request.
In your Pull Request you need to provide information to show that the channel is only available via a private paid subscription.
Note: Public taxes (whether national or regional, whether called TV License or not) do not constitute a private paid subscription.
If a stream is broken, simply move the channel to the invalid category and replace [>] with [x] in the url column.