[Skip to content](https://github.com/Free-TV/IPTV#start-of-content)
You signed in with another tab or window. [Reload](https://github.com/Free-TV/IPTV) to refresh your session.You signed out in another tab or window. [Reload](https://github.com/Free-TV/IPTV) to refresh your session.You switched accounts on another tab or window. [Reload](https://github.com/Free-TV/IPTV) to refresh your session.Dismiss alert
{{ message }}
### Uh oh!
There was an error while loading. [Please reload this page](https://github.com/Free-TV/IPTV).
[Free-TV](https://github.com/Free-TV)/ **[IPTV](https://github.com/Free-TV/IPTV)** Public
- [Notifications](https://github.com/login?return_to=%2FFree-TV%2FIPTV) You must be signed in to change notification settings
- [Fork\\
2.8k](https://github.com/login?return_to=%2FFree-TV%2FIPTV)
- [Star\\
18.8k](https://github.com/login?return_to=%2FFree-TV%2FIPTV)
master
[**7** Branches](https://github.com/Free-TV/IPTV/branches) [**0** Tags](https://github.com/Free-TV/IPTV/tags)
[Go to Branches page](https://github.com/Free-TV/IPTV/branches)[Go to Tags page](https://github.com/Free-TV/IPTV/tags)
Go to file
Code
Open more actions menu
## Folders and files
| Name | Name | Last commit message | Last commit date |
| --- | --- | --- | --- |
| ## Latest commit
PlaylistBot
[Update Playlist (GitHub Actions)](https://github.com/Free-TV/IPTV/commit/afb5425a50d3d0a96a6e291e38ed269d45baa344)
last weekJun 30, 2026
[afb5425](https://github.com/Free-TV/IPTV/commit/afb5425a50d3d0a96a6e291e38ed269d45baa344) · last weekJun 30, 2026
## History
[1,580 Commits](https://github.com/Free-TV/IPTV/commits/master/)
Open commit details
[View commit history for this file.](https://github.com/Free-TV/IPTV/commits/master/) 1,580 Commits |
| [.github/workflows](https://github.com/Free-TV/IPTV/tree/master/.github/workflows "This path skips through empty directories") | [.github/workflows](https://github.com/Free-TV/IPTV/tree/master/.github/workflows "This path skips through empty directories") | [Create pylint.yml (](https://github.com/Free-TV/IPTV/commit/598aa799ad631cc22c59512d4f27f6f3b998638e "Create pylint.yml (#1043)") [#1043](https://github.com/Free-TV/IPTV/pull/1043) [)](https://github.com/Free-TV/IPTV/commit/598aa799ad631cc22c59512d4f27f6f3b998638e "Create pylint.yml (#1043)") | last weekJun 30, 2026 |
| [lists](https://github.com/Free-TV/IPTV/tree/master/lists "lists") | [lists](https://github.com/Free-TV/IPTV/tree/master/lists "lists") | [Update qatar.md (](https://github.com/Free-TV/IPTV/commit/079d9dbfe3b4e1ee99f8ae35fae1aa016b5f09d1 "Update qatar.md (#1058) added qatar television the holy quran channel, fixed qatar television and qatar television 2 links, fixed al araby channel EPG ID and the stream link, and added al jazeera 2 channel") [#1058](https://github.com/Free-TV/IPTV/pull/1058) [)](https://github.com/Free-TV/IPTV/commit/079d9dbfe3b4e1ee99f8ae35fae1aa016b5f09d1 "Update qatar.md (#1058) added qatar television the holy quran channel, fixed qatar television and qatar television 2 links, fixed al araby channel EPG ID and the stream link, and added al jazeera 2 channel") | last weekJun 30, 2026 |
| [playlists](https://github.com/Free-TV/IPTV/tree/master/playlists "playlists") | [playlists](https://github.com/Free-TV/IPTV/tree/master/playlists "playlists") | [Update Playlist (GitHub Actions)](https://github.com/Free-TV/IPTV/commit/afb5425a50d3d0a96a6e291e38ed269d45baa344 "Update Playlist (GitHub Actions)") | last weekJun 30, 2026 |
| [README.md](https://github.com/Free-TV/IPTV/blob/master/README.md "README.md") | [README.md](https://github.com/Free-TV/IPTV/blob/master/README.md "README.md") | [Add Kenyan TV channels: KTN News, Citizen TV, NTV Kenya, KTN Home, K2…](https://github.com/Free-TV/IPTV/commit/c0874efe993e9c1cd26613145b419867a89cc216 "Add Kenyan TV channels: KTN News, Citizen TV, NTV Kenya, KTN Home, K24 TV (#959)") | last weekJun 30, 2026 |
| [epglist.txt](https://github.com/Free-TV/IPTV/blob/master/epglist.txt "epglist.txt") | [epglist.txt](https://github.com/Free-TV/IPTV/blob/master/epglist.txt "epglist.txt") | [Update epglist.txt with working files (](https://github.com/Free-TV/IPTV/commit/a62a2648e2a6c99184e0959679bdacd624527060 "Update epglist.txt with working files (#751) Inserted all EPG urls from https://epgshare01.online/ replacing older ones that were not working anymore") [#751](https://github.com/Free-TV/IPTV/pull/751) [)](https://github.com/Free-TV/IPTV/commit/a62a2648e2a6c99184e0959679bdacd624527060 "Update epglist.txt with working files (#751) Inserted all EPG urls from https://epgshare01.online/ replacing older ones that were not working anymore") | 11 months agoAug 27, 2025 |
| [flag\_order.txt](https://github.com/Free-TV/IPTV/blob/master/flag_order.txt "flag_order.txt") | [flag\_order.txt](https://github.com/Free-TV/IPTV/blob/master/flag_order.txt "flag_order.txt") | [Add Armenia.md (](https://github.com/Free-TV/IPTV/commit/e29339f5213b940b5a68b4c8a600066fe42be731 "Add Armenia.md (#502) * Add Armenian flag * Add armenia.md") [#502](https://github.com/Free-TV/IPTV/pull/502) [)](https://github.com/Free-TV/IPTV/commit/e29339f5213b940b5a68b4c8a600066fe42be731 "Add Armenia.md (#502) * Add Armenian flag * Add armenia.md") | 2 years agoSep 21, 2024 |
| [make\_flags.sh](https://github.com/Free-TV/IPTV/blob/master/make_flags.sh "make_flags.sh") | [make\_flags.sh](https://github.com/Free-TV/IPTV/blob/master/make_flags.sh "make_flags.sh") | [Update flags (](https://github.com/Free-TV/IPTV/commit/417003df2757c6d7d55e542f1a427db1cf1fe3cd "Update flags (#461)") [#461](https://github.com/Free-TV/IPTV/pull/461) [)](https://github.com/Free-TV/IPTV/commit/417003df2757c6d7d55e542f1a427db1cf1fe3cd "Update flags (#461)") | 3 years agoDec 3, 2023 |
| [make\_playlist.py](https://github.com/Free-TV/IPTV/blob/master/make_playlist.py "make_playlist.py") | [make\_playlist.py](https://github.com/Free-TV/IPTV/blob/master/make_playlist.py "make_playlist.py") | [Add tvg-chno support using channel number from markdown lists (](https://github.com/Free-TV/IPTV/commit/ea332da787d0a02c99a773786384104a39fb7429 "Add tvg-chno support using channel number from markdown lists (#1018) * Add channel number to M3U line formatting Add tvg-chno support using channel number from markdown lists - Extract channel number from md lists - Add tvg-chno attribute to M3U output - Skip invalid values (e.g. 0) Improves channel ordering in IPTV clients like Jellyfin * Update make_playlist.py Add tvg-chno support using channel number from markdown lists - Extract channel number from md lists - Add tvg-chno attribute to M3U output - Skip invalid values (e.g. 0) Improves channel ordering in IPTV clients like Jellyfin * Delete playlists/playlist_italy.m3u8 delete italy playlist for updating with channel number * Italy playlist updated with channel number") [#1018](https://github.com/Free-TV/IPTV/pull/1018) [)](https://github.com/Free-TV/IPTV/commit/ea332da787d0a02c99a773786384104a39fb7429 "Add tvg-chno support using channel number from markdown lists (#1018) * Add channel number to M3U line formatting Add tvg-chno support using channel number from markdown lists - Extract channel number from md lists - Add tvg-chno attribute to M3U output - Skip invalid values (e.g. 0) Improves channel ordering in IPTV clients like Jellyfin * Update make_playlist.py Add tvg-chno support using channel number from markdown lists - Extract channel number from md lists - Add tvg-chno attribute to M3U output - Skip invalid values (e.g. 0) Improves channel ordering in IPTV clients like Jellyfin * Delete playlists/playlist_italy.m3u8 delete italy playlist for updating with channel number * Italy playlist updated with channel number") | 3 months agoApr 8, 2026 |
| [playlist.m3u8](https://github.com/Free-TV/IPTV/blob/master/playlist.m3u8 "playlist.m3u8") | [playlist.m3u8](https://github.com/Free-TV/IPTV/blob/master/playlist.m3u8 "playlist.m3u8") | [Update Playlist (GitHub Actions)](https://github.com/Free-TV/IPTV/commit/afb5425a50d3d0a96a6e291e38ed269d45baa344 "Update Playlist (GitHub Actions)") | last weekJun 30, 2026 |
| View all files |
## Repository files navigation
# Free TV
[Permalink: Free TV](https://github.com/Free-TV/IPTV#free-tv)
This is an M3U playlist for free TV channels around the World.
Either free locally (over the air):
[](https://github.com/Free-TV/IPTV/blob/master/lists/usa.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/canada.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/uk.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/ireland.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/australia.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/india.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/japan.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/china.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/hong_kong.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/macau.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/taiwan.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/north_korea.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/korea.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/denmark.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/faroe_islands.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/greenland.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/finland.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/iceland.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/norway.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/sweden.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/estonia.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/latvia.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/lithuania.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/belgium.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/netherlands.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/luxembourg.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/germany.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/austria.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/switzerland.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/poland.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/czech_republic.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/slovakia.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/hungary.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/romania.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/moldova.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/bulgaria.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/france.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/italy.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/portugal.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/spain.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/russia.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/belarus.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/ukraine.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/armenia.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/azerbaijan.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/georgia.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/bosnia_and_herzegovina.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/croatia.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/montenegro.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/north_macedonia.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/serbia.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/slovenia.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/albania.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/kosovo.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/greece.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/cyprus.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/andorra.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/malta.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/monaco.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/san_marino.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/iran.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/iraq.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/israel.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/qatar.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/turkey.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/united_arab_emirates.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/argentina.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/costa_rica.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/dominican_republic.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/mexico.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/paraguay.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/peru.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/venezuela.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/brazil.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/trinidad.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/chad.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/somalia.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/indonesia.md)[](https://github.com/Free-TV/IPTV/blob/master/lists/kenya.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](https://raw.githubusercontent.com/Free-TV/IPTV/master/playlist.m3u8).
# Philosophy
[Permalink: Philosophy](https://github.com/Free-TV/IPTV#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
[Permalink: Feed sources](https://github.com/Free-TV/IPTV#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](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
[Permalink: Format](https://github.com/Free-TV/IPTV#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
[Permalink: Issues](https://github.com/Free-TV/IPTV#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
[Permalink: Pull Requests](https://github.com/Free-TV/IPTV#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.
## About
M3U Playlist for free TV channels
### Topics
[help-wanted](https://github.com/topics/help-wanted "Topic: help-wanted") [looking-for-contributors](https://github.com/topics/looking-for-contributors "Topic: looking-for-contributors")
### Resources
[Readme](https://github.com/Free-TV/IPTV#readme-ov-file)
### Uh oh!
There was an error while loading. [Please reload this page](https://github.com/Free-TV/IPTV).
[Activity](https://github.com/Free-TV/IPTV/activity)
[Custom properties](https://github.com/Free-TV/IPTV/custom-properties)
### Stars
**18.8k**
stars
### Watchers
**720**
watching
### Forks
[**2.8k**\\
forks](https://github.com/Free-TV/IPTV/forks)
[Report repository](https://github.com/contact/report-content?content_url=https%3A%2F%2Fgithub.com%2FFree-TV%2FIPTV&report=Free-TV+%28user%29)
### Uh oh!
There was an error while loading. [Please reload this page](https://github.com/Free-TV/IPTV).
## [Contributors\ 108](https://github.com/Free-TV/IPTV/graphs/contributors)
- [](https://github.com/KAMI911)
- [](https://github.com/freetv332)
- [](https://github.com/NezbednikSK)
- [](https://github.com/TVKaista)
- [](https://github.com/infid0)
- [](https://github.com/telluroid)
- [](https://github.com/Brenders)
- [](https://github.com/salvoc81)
- [](https://github.com/dp247)
- [](https://github.com/glotovpa)
- [](https://github.com/almi05)
- [](https://github.com/nelsonhef)
- [](https://github.com/nrichw-eta)
[\+ 94 contributors](https://github.com/Free-TV/IPTV/graphs/contributors)
## Languages
- [Python84.1%](https://github.com/Free-TV/IPTV/search?l=python)
- [Shell15.9%](https://github.com/Free-TV/IPTV/search?l=shell)
You can’t perform that action at this time.