iptv-org/iptv is a large public IPTV playlist project. It collects publicly accessible IPTV channel links from around the world and organizes them into M3U playlists, making it easy to open them in video players that support network streams.
It is not a video hosting site, nor is it a player. More accurately, it is an index of public channel links: the repository maintains channel lists, playlist entry points, and related documentation, while the actual video content is still provided by the original stream URLs.
How to use it
The most direct way is to paste the playlist URL into a player that supports network streams, such as VLC, IINA, PotPlayer, or another IPTV player that supports M3U.
The main playlist URL given in the project README is:
|
|
The basic workflow is simple:
- Open the player.
- Choose network stream or open network URL.
- Paste the M3U URL.
- Wait for the player to load the channel list.
If you do not want to load every channel, you can also check PLAYLISTS.md for playlists organized by region, language, category, and other dimensions.
Related resources
This project is not just a single M3U file. The README also points to several related repositories and resources:
iptv-org/epg: provides tools related to electronic program guides.iptv-org/database: the source of channel data; channel information issues should be reported there.iptv-org/api: provides API documentation.iptv-org/awesome-iptv: collects more IPTV-related resources.FAQ.md: answers common questions.CONTRIBUTING.md: explains how to submit channels or fix information.
This split is clear: the iptv repository is responsible for playlists, while channel metadata, program guides, API documentation, and resource indexes are handled by other repositories.
Where it fits
It is useful for:
- Browsing public live TV sources in one player.
- Testing whether an IPTV player supports M3U.
- Looking for public channel entry points by region or language.
- Preparing public channel lists for a home media center, TV box, or NAS media service.
- Studying M3U playlist structure and IPTV data organization.
If you only occasionally watch one channel, a website or official app may be simpler. But if you prefer to manage live sources in a single player, M3U playlists are much more convenient.
What to watch for
Public IPTV lists have several natural limitations.
First, stability is not guaranteed. Channel links may expire, change address, be region-locked, be ISP-limited, or temporarily fail because of server issues.
Second, loading speed and picture quality depend on the original stream URL. Playback stutter is not necessarily a player problem; it may come from source bandwidth, location, or network routing.
Third, legality needs to be judged by the user. iptv-org emphasizes that the repository does not store video files and only contains user-submitted public video stream URLs. If a link infringes copyright, rights holders can request removal through an issue; but to remove the content from the internet, they need to contact the site or service actually hosting it.
So the safer interpretation is: this project provides an index of public links. It does not endorse the long-term availability, copyright status, or regional authorization of every channel.
Use in self-hosted media systems
If you use Jellyfin, Kodi, TVHeadend, Plex, or another media center at home, public M3U playlists can serve as live TV inputs.
Common uses include:
- Adding an M3U playlist to a media center.
- Pairing it with EPG to display schedules.
- Filtering by country, language, or channel category.
- Creating a smaller personal list of frequently used channels.
However, it is not a good idea to load the entire global channel list into every device. There are many channels, and loading and searching can become slow. A more practical approach is to choose the relevant subset from the project’s classified playlists, then add that smaller list to your preferred player.
Contribution and maintenance
iptv-org/iptv is a community-maintained project. The README reminds users to read the contribution guide before opening issues or pull requests.
The hard part of maintaining this kind of project is not code, but data quality:
- Whether the channel still plays.
- Whether the channel name is accurate.
- Whether country, language, and category are correct.
- Whether the link is duplicated.
- Whether there is a copyright complaint.
- Whether a more stable replacement stream exists.
For contributions, it is best to provide a clear source and verifiable information, instead of only dropping a link. Otherwise, maintainers have a hard time deciding whether it belongs in the public playlist.
Summary
iptv-org/iptv is a public IPTV channel playlist project. Its main value is organizing global public channel links into M3U lists that can be used directly in players.
It is useful for testing IPTV players, setting up a live TV entry point for a home media center, finding public channels, and studying M3U data structure. But its boundaries matter: it does not host videos, does not guarantee every link will stay available, and does not judge copyright or regional authorization for users.
If you just want to try it quickly, start with the main playlist:
|
|
For long-term use, it is better to filter a smaller list by region and language, then manage it with EPG and a media center tool.
References:
- GitHub: https://github.com/iptv-org/iptv