IPTV GitHub & iptv-org: What They Actually Are
Search for IPTV playlists and you'll quickly land on GitHub, and specifically on iptv-org — an open-source project that indexes thousands of publicly available TV channels from around the world. It's the most-referenced free IPTV resource there is, it's entirely legal, and it's genuinely well built.
It's also widely misunderstood. Here's what it actually is, why it's legal when so much "free IPTV" isn't, and what it deliberately won't give you.
- iptv-org is an open-source index of publicly broadcast channels — not a service, not a provider.
- It’s legal because it only lists streams broadcasters publish openly.
- Playlists are organised by country, language and category, and updated automatically.
- It deliberately excludes premium and paywalled content — that’s a policy, not an oversight.
What iptv-org actually is
It's a community project hosted on GitHub, the platform developers use to share and collaborate on open-source code. Volunteers maintain a large catalogue of publicly accessible TV channel streams, along with metadata — country, language, category, logo — and publish it as M3U playlists anyone can load into a player.
Crucially, the project doesn't host or broadcast anything. It's an index. Every stream it lists is one a broadcaster has already published openly on the internet; iptv-org simply catalogues where they are and keeps the catalogue tidy.
That distinction is the whole reason it exists in the open, under its real name, on the world's largest code platform — rather than on an anonymous site that changes domain every few months.
Why it's legal when other free IPTV isn't
Two reasons, both structural:
It only indexes free-to-air streams. These are channels the broadcaster has chosen to make publicly available. Listing a public address isn't circumventing anything.
It excludes paywalled content by policy. The project explicitly won't accept streams for channels that require a subscription or are otherwise protected. That's a deliberate editorial line, and it's what keeps the whole thing above board.
Compare that with a list promising premium sport for free — those streams are encrypted and licensed, and redistributing them is infringement regardless of who's hosting the list. Our guide to free playlists covers that side honestly.
How it's organised
The catalogue is split sensibly, which is what makes it usable rather than an undifferentiated dump:
- By country — a playlist per nation, so you can grab just the region you want.
- By language.
- By category — news, sport, music, kids, documentary, religious and so on.
- A full index, if you genuinely want everything.
There's also automated maintenance: the project runs regular checks and removes streams that have gone dead, which is why it stays usable while most circulated lists rot. That automation is the single biggest practical advantage over a random forum list.
The complete index runs to many thousands of entries and will make most players sluggish, especially on a Firestick or Smart TV. Load the specific country or category playlist instead — you’ll get a fast, browsable list of things you might actually watch rather than scrolling past hundreds of channels in languages you don’t speak.
What it won't give you
Being clear about the limits, because this is where expectations go wrong:
- No premium sport. Not now, not ever — that's the project's policy.
- No premium film or pay-TV entertainment channels.
- No programme guide in the way a paid service provides.
- No support. It's volunteer-run open source.
- Variable quality. Many free-to-air feeds are standard definition, and some are unreliable regardless of the index being accurate.
It's an excellent index of free television. It is not, and doesn't pretend to be, a substitute for a subscription.
Who it's genuinely useful for
- Testing a player or a new device with real streams before your subscription arrives.
- International news, where free-to-air coverage is genuinely strong.
- Developers and tinkerers building something — the structured metadata is the real draw.
- Anyone curious about what's broadcast openly worldwide.
If that's you, it's a great resource and it costs nothing. Our public playlists guide covers loading one, and our M3U guide explains the format.
The honest summary
iptv-org is the best-run free IPTV resource going, and it's legitimate in a way most "free IPTV" isn't — precisely because it limits itself to content that's genuinely free. That self-imposed limit is also why it can't replace a paid service for UK viewers who want sport, films and a working guide.
Use it for what it's good at, and pay for the rest. That's the realistic split, and a dependable best IPTV service UK covers the half that free can't.
Frequently asked questions
What is iptv-org?
An open-source project on GitHub that indexes thousands of publicly broadcast TV channels worldwide and publishes them as M3U playlists organised by country, language and category.
Is the iptv-org GitHub legal?
Yes. It only indexes free-to-air streams that broadcasters publish openly, and it excludes paywalled content by policy. It doesn't host any streams itself.
How do I use iptv-org playlists?
Copy the M3U link for the country or category you want and add it in your player's playlist settings. Use a specific list rather than the full index.
Does iptv-org have premium channels?
No, and deliberately so. The project excludes subscription and protected content, which is what keeps it legal.
Why are some iptv-org channels offline?
Streams move or shut down over time. The project runs automated checks to prune dead entries, but there's always some lag.