GitHub IPTV Playlists That Actually Work (2026)

Q: What is the best GitHub IPTV playlist?

iptv-org/iptv is the best all-rounder: ~10,000 channels, rebuilt daily, split by country, language and category, and served from GitHub Pages so URLs are stable. Free-TV/IPTV is the most reliable curated starter for HD free-to-air channels. For the lowest broken-link rate, Romaxa55/world_ip_tv re-checks every 6 hours.

Q: How do I get the M3U URL from a GitHub repo?

Open the .m3u file in the repo, click the Raw button, and copy the raw.githubusercontent.com URL. Or convert the page URL: replace github.com with raw.githubusercontent.com and remove /blob/ from the path. Paste that raw URL into your player. Projects hosted on GitHub Pages (like iptv-org) publish a ready URL under .github.io.

Q: Why did an IPTV GitHub repo disappear?

Repos get removed for DMCA takedowns, unlicensed channel links, or the maintainer going inactive. iptv-org and Free-TV survive because they list free-to-air streams, host no video and honour removal requests. If your playlist 404s, switch to a maintained repo and re-add it by URL.

Q: Are GitHub IPTV playlists legal?

The technology is legal. Legality depends on whether each stream is free-to-air and published by the rights holder. iptv-org and Free-TV state they link only to streams they believe are public, host no video and comply with takedowns. Stick to those, avoid repos promising premium pay channels for free, and check your local rules.

Q: Do GitHub playlists work in TiviMate and IPTV Smarters Pro?

Yes. Any M3U raw URL from GitHub loads in TiviMate, IPTV Smarters Pro, OTT Navigator, Kodi and VLC. Add it as an M3U URL by URL so it auto-updates when the repo rebuilds. Small category or country slices load faster than the full index.m3u.

Q: Why does my GitHub playlist show old or missing channels?

GitHub's CDN and raw.githubusercontent.com cache files for a few minutes, so a brand-new build can lag. Also make sure you loaded the .m3u file, not the README. Update the playlist in your player, and prefer country/category slices to cut dead entries.

If you have searched for a free IPTV playlist, you have already met GitHub. Almost every working list of free-to-air channels lives in an open repository - iptv-org/iptv most of all. Search "github iptv" and the top results are not guides, they are raw repos with tens of thousands of stars.

That is good news once you understand how to use them. The trick is that a repo page is not a playlist - you need the raw M3U URL, and you need to pick the right file. This guide walks through the repos actually worth loading in 2026, how to pull the raw URL from any of them, and the GitHub-specific problems (caching, takedowns, rate limits) that trip people up. Sources here host no premium channels - only free-to-air feeds.

Bottom line: Load iptv-org/iptv by URL for scale and Free-TV/IPTV for a reliable curated core. Always paste the raw URL, prefer a country or category slice over the full 10k file, and re-add by URL so it auto-updates when the repo rebuilds. Full source list and EPG: see our Free & Public IPTV Playlists guide.

Quick Answer - Copy-Paste URLs

These are the ready-to-paste URLs from the two main projects (no repo browsing needed). Add them in your player as Add playlist → URL.

https://iptv-org.github.io/iptv/index.m3u              # iptv-org: everything (~10k - slow)

https://iptv-org.github.io/iptv/categories/news.m3u    # iptv-org: news slice

https://iptv-org.github.io/iptv/countries/us.m3u       # iptv-org: USA slice

https://raw.githubusercontent.com/Free-TV/IPTV/master/playlist.m3u8   # Free-TV: curated HD core

Notice the two URL patterns: iptv-org publishes through GitHub Pages (iptv-org.github.io) while Free-TV is pulled raw (raw.githubusercontent.com). Both work in any M3U player. Test in VLC first.

Best GitHub IPTV Repos Compared

I loaded each repo's playlist by URL in October 2026 and checked update history, file size, and a 50-channel spot-check in VLC. Same search term, very different maintenance.

Repository	Channels	Updates	Best for
iptv-org/iptv	~10k+	Daily (auto-build)	All-rounder - country / language / category slices
Free-TV/IPTV	Curated core	Regular hand curation	Most reliable starter - HD, one link per channel
Romaxa55/world_ip_tv	Working-only subset	Every 6h (bot)	Lowest broken-link rate (auto-verified)
shovo127/IPTV-By-Shovo	By category	Daily (2026-maintained)	Category browsing
jromero88/iptv	By country & category	Community	Neat slices incl. a VOD list

Pick iptv-org + Free-TV to cover scale and reliability. We host no streams - every link points at third-party public repos.

How to Get the Raw M3U URL From Any GitHub Repo

The single most common mistake is pasting the repo page URL (github.com/...) into a player. That returns HTML, not a playlist. You need the raw file. Three ways to get it:

1. The Raw button (easiest)

Open the .m3u or .m3u8 file in the repo, click Raw (top-right of the file view), then copy the URL from the address bar. It will start with raw.githubusercontent.com.

2. Convert the URL by hand

Take a file page like github.com/Free-TV/IPTV/blob/master/playlist.m3u8 and rewrite it: change github.com to raw.githubusercontent.com, and delete /blob/. The result - raw.githubusercontent.com/Free-TV/IPTV/master/playlist.m3u8 - is the URL a player needs.

3. Use the GitHub Pages URL (when the project offers one)

Repos like iptv-org publish finished files at <user>.github.io/<repo>/.... These are the cleanest URLs to paste - https://iptv-org.github.io/iptv/countries/us.m3u - and they never expose blob/raw paths.

Not sure which file to grab? Every repo keeps an index. iptv-org's PLAYLISTS.md lists every country, language and category slice, so you can jump straight to the one you want instead of the 10k global file.

Why Everyone Uses iptv-org

iptv-org is the reference project for free-to-air IPTV, and it is why "iptv-org" is searched as often as "github iptv" itself. Three things make it the default:

Scale with structure. Around 10,000 channels, split into countries/, languages/ and categories/ files, plus a master index.m3u. You almost never want the master file - a slice is faster and cleaner.
It hosts no video. The repo only stores text lists of stream URLs that the maintainers believe are public. That is why it has survived where piracy repos get taken down.
A matching EPG. The separate iptv-org/epg project builds XMLTV guides by country, so your TV guide lines up with the playlist.

For the category file list, EPG setup and how slices compare, our public IPTV playlist guide covers the whole picture. Here the point is simpler: if you only remember one repo, remember iptv-org, and remember to grab a slice.

Loading a Repo Playlist in Any Player

Raw URLs and GitHub Pages URLs are standard M3U links, so every player takes them the same way. Always load by URL, never by one-time download, so the list refreshes when the repo rebuilds.

TiviMate (Android TV / Fire TV)

Settings → Playlists → Add playlist → Enter URL → paste → Next. Full walkthrough: TiviMate setup.

IPTV Smarters Pro

Add Playlist → Login with M3U URL → any name → paste the raw URL → Add User. See IPTV Smarters Pro.

VLC, Kodi, Smart TV players

VLC: Media → Open Network Stream → paste → Play (VLC guide). Kodi: PVR IPTV Simple Client → M3U URL. Samsung/LG: paste into your player's playlist upload box - see Smart IPTV.

Start with a small slice to confirm playback before pushing a big list to your TV. If channels buffer, that is the source, not the repo - see IPTV buffering fixes.

GitHub Pitfalls: Caching, Rate Limits and Takedowns

GitHub makes a great host for playlists, but it comes with quirks that look like bugs:

Channels look a day old

GitHub's CDN and raw.githubusercontent.com cache files for a few minutes, sometimes longer. If a just-rebuilt playlist still looks stale, wait and refresh the playlist in your player rather than re-adding it.

I pasted a repo URL and got a wall of HTML

You copied the page URL, not the raw one. Go back to How to Get the Raw M3U URL - the address must start with raw.githubusercontent.com or <user>.github.io.

The playlist 404s or the repo is gone

Repos get DMCA'd, archived, or abandoned. This is why you pick maintained projects. If iptv-org or Free-TV file paths change, grab the new URL from PLAYLISTS.md and re-add it. Avoid repos that list premium pay channels - they are the ones that vanish.

Loading a playlist by URL into a player makes a normal fetch, not an API call, so GitHub's API rate limits are not usually an issue. Heavy automated scraping of raw files can be, but normal use is fine.

Legal & Safety

GitHub playlists are no different from any other public playlist when it comes to legality: the technology is legal, and whether a list is legal depends on whether each stream is free-to-air and published by the rights holder.

Trust the transparent projects. iptv-org and Free-TV host no video, document their sources, and honour removal requests - that is the model to prefer.
Be suspicious of "10k premium channels free". Lists that promise pay-TV for free are unlicensed and get taken down - or worse, carry malware via sketchy players.
Check your region. A stream that is free in one country can be licensed-only in yours. See our full Is IPTV Legal? explainer.

We host no streams. This page links to open GitHub projects for information and testing. If you rebroadcast or redistribute a filtered copy, do your own rights review.

Frequently Asked Questions

What is the best GitHub IPTV playlist?

iptv-org/iptv - ~10,000 channels, rebuilt daily, split by country/language/category and served via stable GitHub Pages URLs. Free-TV/IPTV is the most reliable curated starter, and Romaxa55/world_ip_tv has the lowest dead-link rate because it re-verifies every 6 hours.

How do I get the M3U URL from a GitHub repo?

Open the .m3u file and click Raw, or rewrite the page URL: change github.com → raw.githubusercontent.com and drop /blob/. Repos on GitHub Pages (like iptv-org) offer a ready <user>.github.io URL instead.

Why did an IPTV GitHub repo disappear?

DMCA takedowns, unlicensed channel links, or an inactive maintainer. iptv-org and Free-TV survive because they list only free-to-air streams, host no video and comply with removals. Re-add a maintained repo by URL if yours 404s.

Are GitHub IPTV playlists legal?

The tech is legal. It depends on each stream being free-to-air and rights-holder-published. Stick to transparent projects, avoid premium-pay promises, and check local rules - see Is IPTV Legal?.

Do GitHub playlists work in TiviMate and IPTV Smarters Pro?

Yes - any raw M3U URL loads in TiviMate, IPTV Smarters Pro, OTT Navigator, Kodi and VLC. Add it as an M3U URL by URL so it auto-updates, and prefer a country or category slice over the full index.m3u.

Why does my GitHub playlist show old or missing channels?

Raw files are CDN-cached for a few minutes, so a fresh build can lag. Make sure you loaded the .m3u file (not the README), refresh the playlist in your player, and use slices to cut dead entries.