jpt
/
IPTV
mirror of https://github.com/Free-TV/IPTV
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
M3U playlist for free TV channels around the World.
1,793 Commits
9 Branches
0 Tags
51 MiB
Python 97.7%
Shell 2.3%
 
 
Go to file
uditmahato 312da84b0f Add a checker that says which channel failed and why 
The checker history records the URLs that failed, but a bare URL does not
say which channel or list it belongs to, so acting on it means matching
891 URLs against 97 files by hand.

It also does not say why a URL failed, and the reasons need different
answers. A 404 means the stream is gone. A 403 is what a channel served
only inside its own country looks like from outside it, and those are in
the lists on purpose. A connection that times out may just be a host
having a bad day.

This reports the channel and the list next to each URL, probes each one
several times so a single blip cannot condemn a channel, and separates
dead from blocked, unreachable and flaky. It reads both playlist formats
the lists use, so a DASH stream is not mistaken for a broken one.
 		2026-08-26 14:44:57 +05:45
.github Switch weekly trend workflow to artifacts instead of repo commits 2026-08-18 13:02:05 +02:00
lists Replace Kanal S dead Wikimedia link with imgur-hosted logo 2026-08-24 10:18:58 +02:00
playlists Update Playlist (GitHub Actions) 2026-08-24 09:21:45 +00:00
.gitignore Fix leftover M3U8 injection vector, missing country codes, README sync 2026-08-16 06:28:29 +02:00
README.md Add Lebanon channel list 2026-08-18 11:49:20 +02:00
check_channels.py Add a checker that says which channel failed and why 2026-08-26 14:44:57 +05:45
epglist.txt Update epglist.txt with working files (#751) 2025-08-27 09:50:57 +02:00
flag_order.txt Add Turkmenistan, Telenorba, Handicap TV; clean up North Macedonia 2026-08-16 18:27:56 +02:00
make_flags.sh Update flags (#461) 2023-12-03 14:47:43 +01:00
make_playlist.py Strip trailing Ⓢ/Ⓖ/Ⓨ markers from tvg-name 2026-08-16 20:44:30 +02:00
playlist.m3u8 Update Playlist (GitHub Actions) 2026-08-24 09:21:45 +00:00

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:

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.