Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Free-TV/IPTV

M3U Playlist for free TV channels
https://github.com/Free-TV/IPTV

help-wanted looking-for-contributors

Last synced: 3 months ago
JSON representation

M3U Playlist for free TV channels

Awesome Lists containing this project

README 

        
Free TV

=======



This is an M3U playlist for free TV channels around the World.



Either free locally (over the air):



[](lists/usa.md)

[](lists/canada.md)

[](lists/uk.md)

[](lists/ireland.md)

[](lists/australia.md)

[](lists/india.md)

[](lists/japan.md)

[](lists/china.md)

[](lists/hong_kong.md)

[](lists/macau.md)

[](lists/taiwan.md)

[](lists/north_korea.md)

[](lists/korea.md)

[](lists/denmark.md)

[](lists/faroe_islands.md)

[](lists/greenland.md)

[](lists/finland.md)

[](lists/iceland.md)

[](lists/norway.md)

[](lists/sweden.md)

[](lists/estonia.md)

[](lists/latvia.md)

[](lists/lithuania.md)

[](lists/belgium.md)

[](lists/netherlands.md)

[](lists/luxembourg.md)

[](lists/germany.md)

[](lists/austria.md)

[](lists/switzerland.md)

[](lists/poland.md)

[](lists/czech_republic.md)

[](lists/slovakia.md)

[](lists/hungary.md)

[](lists/romania.md)

[](lists/moldova.md)

[](lists/bulgaria.md)

[](lists/france.md)

[](lists/italy.md)

[](lists/portugal.md)

[](lists/spain.md)

[](lists/russia.md)

[](lists/belarus.md)

[](lists/ukraine.md)

[](lists/azerbaijan.md)

[](lists/georgia.md)

[](lists/bosnia_and_herzegovina.md)

[](lists/croatia.md)

[](lists/montenegro.md)

[](lists/north_macedonia.md)

[](lists/serbia.md)

[](lists/slovenia.md)

[](lists/albania.md)

[](lists/kosovo.md)

[](lists/greece.md)

[](lists/cyprus.md)

[](lists/andorra.md)

[](lists/malta.md)

[](lists/monaco.md)

[](lists/san_marino.md)

[](lists/iran.md)

[](lists/iraq.md)

[](lists/israel.md)

[](lists/qatar.md)

[](lists/turkey.md)

[](lists/united_arab_emirates.md)

[](lists/argentina.md)

[](lists/costa_rica.md)

[](lists/dominican_republic.md)

[](lists/mexico.md)

[](lists/paraguay.md)

[](lists/peru.md)

[](lists/venezuela.md)

[](lists/brazil.md)

[](lists/trinidad.md)

[](lists/chad.md)

[](lists/somalia.md)



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 represesnts a group. The `
` 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.