explaingit

iptv-org/iptv

🔥 Hot116,312TypeScriptAudience · generalComplexity · 1/5ActiveLicenseSetup · easy

TLDR

A community-maintained collection of live TV channel stream URLs packaged as m3u playlists you can paste into any video player.

Mindmap

mindmap
  root((repo))
    What it does
      Live TV streams
      m3u playlists
      Global channels
    How to use
      Paste URL in player
      Browse channels
      No account needed
    Data sources
      Public streams
      Channel metadata
      Program guides
    Tech stack
      m3u format
      GitHub Actions
      TypeScript
    Use cases
      Watch free TV
      Sample channels
      Build apps

Things people build with this

USE CASE 1

Watch live TV channels from around the world for free without creating an account.

USE CASE 2

Load playlists into video players like VLC or Kodi to browse and stream available channels.

USE CASE 3

Build custom streaming apps or tools that consume the m3u playlist data.

USE CASE 4

Sample international television content across different countries and languages.

Tech stack

TypeScriptm3uGitHub ActionsIPTV

Getting it running

Difficulty · easy Time to first run · 5min
Released under Creative Commons Zero, placing the work in the public domain, use freely for any purpose without restrictions.

In plain English

This project is a community-maintained collection of links to live television channels you can watch over the internet. IPTV stands for Internet Protocol television, which simply means TV streamed over a network instead of cable or satellite. The repository gathers publicly available stream URLs from around the world and packages them into playlist files in the m3u format that most video players understand. The way it works is straightforward. You take the link to one of the provided playlists, paste it into a video player that supports live streaming, and the player loads the list of channels for you to browse and watch. The main playlist with every available channel lives at a fixed URL on the project's site, and additional themed or filtered playlists are listed in a companion file in the repository. Channel metadata comes from a sister database project, an Electronic Program Guide (the schedule of what's airing) is available through another related repository, and there is also an API project that exposes the data programmatically. You would use this if you want a free, no-account way to sample live TV channels from many countries, especially with apps that already accept m3u playlist URLs. The repository itself stores no video, only user-submitted links to streams that copyright holders have made public. The project is released under a Creative Commons Zero license, which essentially places it in the public domain. Updates are automated through a GitHub Actions workflow.

Copy-paste prompts

Prompt 1
How do I add an IPTV m3u playlist to VLC or Kodi to start watching live channels?
Prompt 2
Show me how to parse and filter the m3u playlist file to extract channel names and stream URLs.
Prompt 3
Can I build a simple web app that loads this m3u playlist and displays channels in a grid?
Prompt 4
How do I contribute a new working stream URL to this IPTV playlist repository?
Prompt 5
What's the structure of an m3u file and how do video players read it to load live streams?
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.