Open-source project
iptv-org/iptv avatar
iptv-org/iptv

iptv-org/iptv: A Community-Run Index of Public IPTV Streams, Not a Streaming Service

GitHub describes it as Collection of publicly available IPTV channels from all over the world. The repository metadata lists TypeScript as its primary language. The metadata lists the Unlicense license. This article stays within the project description and details documented in the GitHub repository README.

144,105 stars8,606 forksTypeScriptUnlicense

At a glance

What is it?
iptv-org/iptv collects publicly available IPTV channel URLs into playlists you can open in any video player. It is a data curation project with real legal and reliability caveats, not a hosting platform.
Who is it for?
Adopt iptv-org/iptv if you need a free, community-maintained source of public IPTV channel URLs for testing, hobby projects, or personal viewing in a player that supports M3U. Avoid it if you require guaranteed uptime, official licensing, or a stable EPG, because streams can die without notice and the project holds no control over link destinations.
Can I use it commercially?
Yes. Unlicense is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository last received commits 1 day ago.
What is it written in?
Mainly TypeScript, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • iptv-org/iptv144,105 ★ · +8,347
Star history
Repository2026-08-132026-11-15
iptv-org/iptv135.8k144.1k

8,347 Stars in the last 94 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

What Problem It Solves and Who It Is For

The repository solves a discovery problem. There are thousands of publicly accessible IPTV streams on the internet, but finding them usually means scattered forums, dead links, and no central list. iptv-org/iptv collects those links into playlists. The intended audience is anyone who wants to watch live TV without a cable subscription, or developers who need test streams for their own applications. The README is explicit that the project contains no video files, only user-submitted links to streams that are, to the best of the maintainers' knowledge, intentionally made public by copyright holders. So this is not a pirate streaming service; it is a directory. The practical value is that you can paste a single URL into a compatible player and get a working channel list, without hunting for individual streams.

The Actual Mechanism: Playlists, Database, and API

The core artifact is a single M3U playlist at https://iptv-org.github.io/iptv/index.m3u. That playlist contains all channels available in the repository. But the project is more than one file. Channel metadata lives in a separate repository, iptv-org/database,. The iptv-org/iptv repository itself is mostly a build output: it generates playlists from that database. The README points to an API in iptv-org/api for programmatic access, and to an EPG tool in iptv-org/epg for electronic program guide data. So the data flow is: database holds channel info, iptv-org/iptv compiles it into M3U files, and the API serves structured queries. This separation matters because it means you can contribute corrections to the database without touching the playlists directly. The build is automated via a GitHub Actions workflow, as shown by the badge in the README.

How to Get It Running: Real Commands and Config

You do not install this project as a package. The README says to simply paste the playlist link into any video player that supports live streaming and press Open. For the main playlist, that URL is https://iptv-org.github.io/iptv/index.m3u. If you want a subset, the PLAYLISTS.md file lists links to other playlists, which are not listed in the README. For developers, the API documentation is in the iptv-org/api repository, and the EPG utilities are in iptv-org/epg. The repository does contain a package.json and an m3u-linter.json for its own maintenance scripts, but using the playlists needs neither. The contribution path is more concrete: you open an issue or pull request after reading CONTRIBUTING.md. The legal section specifies that copyright holders can request removal of a link by opening a special issue template, but the maintainers note they have no control over the destination of the link.

A Genuine Limitation: No Control Over Stream Availability

The biggest limitation is that the project only links to streams; it does not host them. That means a channel can disappear at any time if the upstream server goes down, changes its URL, or blocks access. The README admits this indirectly: the maintainers have no control over the destination of the link, and removing a link from the playlist does not remove the content from the web. So if you rely on this for critical viewing, you will encounter dead channels. Also, the quality of streams is not guaranteed. Some may be low resolution, geo-restricted, or require specific codecs. The project does not provide any uptime statistics or health checks in the README. For a production application, this is a fragile dependency. You would need to implement your own validation and fallback logic. The EPG is also separate, meaning you must use a different tool to get program schedules, and that tool may not cover all channels in the playlist.

The Wrong Tool for Legal Certainty

If you need legally guaranteed content, this is the wrong tool. The README's legal section is careful but revealing. It says the repository contains user-submitted links to publicly available streams, and that linking does not directly infringe copyright because no copy is made. That is a legal position, not a guarantee. The maintainers also state they have no control over the destination of the link, so a stream that was publicly accessible when added could later become restricted or unauthorized. For a business that needs to distribute live TV, you would be better off with licensed IPTV providers or official broadcaster apps. The Unlicense license on the repository itself means the code and data are public domain, but that does not extend to the underlying streams. You cannot rely on this project to protect you from copyright claims. The repository also has a FAQ.md.

Alternative: iptv-org/epg and Other Curated Lists

A real alternative is the iptv-org/epg repository, which is not a competitor but a complementary tool. It provides utilities to generate an Electronic Program Guide for the channels in this playlist. The difference in approach is that iptv-org/iptv gives you the stream URLs, while iptv-org/epg gives you the schedule data. If you need both, you must use both. Another alternative is to build your own playlist from official broadcaster websites. That approach gives you more control over stream quality and legality, but it requires significant manual effort and maintenance. There are also commercial IPTV services that offer stable, licensed streams, but they charge a fee and are not open source. The key difference is that iptv-org/iptv is a free, community-curated index with no guarantees, whereas commercial services offer reliability at a cost. For a hobby project, the free index is often sufficient; for a business, it is not.

Maintenance and Upgrade Cost

The maintenance burden is on the community, not on you as a user. The README shows that the project relies on contributions: you can open issues in the database repository for errors, and you can contribute to the playlists via pull requests. There is a Contributing Guide that must be read before sending an issue or PR. The project is not archived and has an active workflow badge, and the last push was on 2026-11-01. If you fork this repository, you take on the cost of regenerating playlists when the database changes. The API and EPG are separate repositories, so you would need to track updates in three places. The Unlicense means you can use the code without restrictions, but that also means there is no warranty or support. Upgrade cost is low if you just consume the hosted playlists, but it becomes higher if you rely on the API or EPG..

Editorial conclusion

Adopt iptv-org/iptv if you need a free, community-maintained source of public IPTV channel URLs for testing, hobby projects, or personal viewing in a player that supports M3U. Avoid it if you require guaranteed uptime, official licensing, or a stable EPG, because streams can die without notice and the project holds no control over link destinations. Before relying on it, verify that your intended use complies with your local copyright laws and read the FAQ.md. The project is a useful index, but it is not a service with any uptime promise.

Frequently asked questions

What is IPTV.org on GitHub?

It is the iptv-org/iptv repository, a collection of publicly available IPTV channels from all over the world. It stores no video: it holds user-submitted links to stream URLs and publishes them as m3u playlists.

What is at iptv-org.github.io/iptv?

That address serves the main playlist, index.m3u, the file containing all channels available in the repository. You paste it into any video player that supports live streaming and press Open.

Does the iptv-org/iptv repository store any video files?

No. It contains only user-submitted links to publicly available video stream URLs, and the project states it has no control over the destination of those links. Removing a link does not remove the stream from the web.

How do I report a wrong channel name in iptv-org/iptv?

Open the issue in the iptv-org/database repository, which is where all channel data comes from.

How do I get a copyrighted stream removed from iptv-org/iptv?

File an issue using the copyright claim template in this repository to have the link removed. To remove the content itself, the project says to contact the host actually serving it, not GitHub and not the maintainers of the repository.

Official sources

  1. Official documentation
  2. Official README
  3. Project repository
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/iptv-org-iptv.svg)](https://hysenlabs.com/projects/iptv-org-iptv)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/iptv-org-iptv.svg)](https://hysenlabs.com/projects/iptv-org-iptv)

Was this useful?