Search for IPTV GitHub and you will land on a project that has quietly become one of the largest open catalogues of publicly available television streams on the internet. It is called iptv-org, it is maintained entirely by volunteers, and everything in it is free to use. For anyone who wants to try IPTV without paying for anything or signing up for anything, this is the honest starting point.
This guide explains what the project actually contains, how the playlists are organised, how to load them into a player, and — importantly — where the realistic limits are.
What is iptv-org?
iptv-org is a community-maintained repository hosted on GitHub that collects publicly accessible IPTV stream links. The key word there is publicly accessible. The project does not host video, does not decrypt anything, and does not bypass any paywall. It is a directory — a very large, very well organised list of URLs that broadcasters have already put on the open internet themselves.
Many national broadcasters, regional news channels, government channels, religious networks and shopping channels stream openly as a matter of policy. iptv-org indexes those. If you are new to the underlying technology, our beginner’s guide to IPTV covers how these streams reach your screen.
What is actually in the repository?
The main repo is not just one playlist. It is a structured set of them:
- The master playlist — every indexed channel in one enormous M3U file. Thousands of entries. Useful for browsing, unwieldy for daily use.
- By country — separate playlists for each country code, so you can pull only German, Spanish, US or Moroccan channels.
- By language — grouped by the language of broadcast rather than the country of origin.
- By category — news, music, documentary, kids, weather, religious, and so on.
- By region — broader groupings such as Europe, MENA or Latin America.
Alongside the playlists, the organisation runs companion repositories: a channel database with logos and metadata, an EPG project that aggregates programme guides from public sources, and a free JSON API that developers can query directly.
How to use an iptv-org playlist
You do not clone the repository or install anything. You copy a raw playlist URL from GitHub and paste it into a player. That is the entire process.
In VLC
- Open the repository page and navigate to the playlist you want — for example the index for your country.
- Click the Raw button and copy the URL from the address bar.
- In VLC, open Media → Open Network Stream, paste, and press Play.
Our VLC IPTV guide walks through the desktop and mobile versions in more detail.
In TiViMate or another Android player
Add the same raw URL as an M3U playlist source. The player will fetch it and build a channel list. Because the file is refreshed by the project, your list stays reasonably current without you doing anything. See our TiViMate guide for the setup steps.
Getting a programme guide
The iptv-org EPG project publishes XMLTV feeds per source. Add the relevant URL as an EPG source in your player and it will match channels by their tvg-id. Coverage is patchy — some countries are well served, others have almost nothing — but it costs nothing to try.
Be realistic about quality
This is where honesty matters more than enthusiasm. Free public streams are free public streams, and they behave accordingly:
- Links break constantly. A broadcaster changes a CDN path and a channel dies. Volunteers fix these when they notice, which is not always quickly.
- Bitrates vary wildly. Some channels are clean 1080p; plenty are 480p or worse.
- Geo-blocking applies. A stream indexed as available may still refuse to play from your country.
- No premium content. There are no subscription sports channels, no pay-TV movie networks, no PPV. There never will be, because those broadcasters do not publish open streams.
- Uptime is not guaranteed. Nobody owes you a working channel.
If a channel refuses to play, work through our IPTV not working guide before assuming the link is dead — and our buffering fixes cover the stuttering that low-bitrate public streams often produce.
Is using iptv-org legal?
The project itself operates on solid ground: it links to streams the rights holders have chosen to publish openly. Watching a national broadcaster’s own public live feed is not piracy — it is the intended use of that feed.
Two caveats are worth stating plainly. First, the repository is community-submitted, and occasionally a link slips in that should not be there; the maintainers remove them on notice, but the list is not audited in real time. Second, using a VPN to defeat a geo-restriction may breach a broadcaster’s terms of service even where the stream is free.
For the broader legal picture — and the distinction between free-to-air sources like this and unlicensed redistribution — read our article on IPTV and the law and our breakdown of what makes an IPTV service illegal.
Other IPTV projects on GitHub
iptv-org is the largest, but not the only one. The wider ecosystem includes open-source players such as IPTVnator and Televizo, XMLTV grabber projects that build guides by scraping public schedules, and Xtream Codes API client libraries that developers use to build their own front-ends. Searching GitHub for the IPTV topic tag surfaces hundreds of these, at every level of maintenance.
Should you contribute?
The project accepts pull requests. If you find a public stream from your country that is not indexed, or you spot a dead link, the contribution guidelines in the repository explain the format. It is a low-friction way into open-source contribution, and the maintainers are responsive.
Final thoughts
iptv-org is the best free entry point into IPTV that exists, and it is worth understanding for what it is rather than what people sometimes hope it will be. It will not hand you a premium sports package. What it will do is give you thousands of legitimate, openly published channels from every corner of the world, cost nothing, ask for no account, and let you learn how playlists, EPGs and players fit together before you spend a single euro. For a lot of people, that is more than enough.