What is this?
A community-maintained M3U playlist of free-to-watch live TV channels from around the world — local over-the-air feeds plus free internet services. You load it into any IPTV player.
A community-maintained M3U playlist of free-to-watch live TV channels from around the world — local over-the-air feeds plus free internet services. You load it into any IPTV player.So it's not an app — what do I actually get?Nothing to install: you get an m3u8 playlist URL to point your IPTV player at. The repo itself holds the makeplaylist.py script and per-group .md source files that generate the playlist.
Nothing to install: you get an m3u8 playlist URL to point your IPTV player at. The repo itself holds the makeplaylist.py script and per-group .md source files that generate the playlist.How do I start watching?Open the IPTV player you already use and set its playlist URL to the m3u8 link published in this repo — the player then shows all channels grouped as in the playlist.
Open the IPTV player you already use and set its playlist URL to the m3u8 link published in this repo — the player then shows all channels grouped as in the playlist.Will every channel work in my country?Not everywhere: GeoIP-blocked channels (G) only work in the countries they are listed for, YouTube streams can go offline, and broken channels sit in the Invalid category until fixed.
Not everywhere: GeoIP-blocked channels (G) only work in the countries they are listed for, YouTube streams can go offline, and broken channels sit in the Invalid category until fixed.Why keep the list small instead of adding every channel it can find?The stated philosophy is quality over quantity — 'The less channels we support the better.' Every entry must work well, ideally in HD, be free of charge, and have exactly one canonical URL, so reliability is traded against volume.
The stated philosophy is quality over quantity — 'The less channels we support the better.' Every entry must work well, ideally in HD, be free of charge, and have exactly one canonical URL, so reliability is traded against volume.How do I add a channel I know is free?Open a pull request that edits only the .md list files: include proof the channel is free, host its logo on imgur.com, prefix a working URL with [>], and name the country for geoblocked streams so maintainers can test them. Never edit the generated m3u8 files.
Open a pull request that edits only the .md list files: include proof the channel is free, host its logo on imgur.com, prefix a working URL with [>], and name the country for geoblocked streams so maintainers can test them. Never edit the generated m3u8 files.What happens to a channel when its stream dies?Contributors move it to the Invalid category and replace [>] with [x] in the URL column — only rows whose URL starts with [>] are included in the generated playlist.
Contributors move it to the Invalid category and replace [>] with [x] in the URL column — only rows whose URL starts with [>] are included in the generated playlist.What are similar projects?awesome-iptv, iptv, IPTV, iptv-api, bug, LibreTV, m3u, Tvlist-awesome-m3u-m3u8
awesome-iptv, iptv, IPTV, iptv-api, bug, LibreTV, m3u, Tvlist-awesome-m3u-m3u8Which topics is it in?help-wanted, m3u, playlist, m3u8, hls, iptv, media, tv, live-streaming, video-streaming, github-actions, streaming
help-wanted, m3u, playlist, m3u8, hls, iptv, media, tv, live-streaming, video-streaming, github-actions, streaming