explaingit

iptv-org/iptv

Analysis updated 2026-06-20

115,965TypeScriptAudience · generalComplexity · 1/5LicenseSetup · easy

TLDR

A community-maintained collection of publicly available live TV stream links from around the world, packaged into m3u playlist files you can load into any compatible video player.

Mindmap

mindmap
  root((iptv))
    What it does
      Aggregates stream URLs
      Builds m3u playlists
      Filters by country
    Content
      Live TV channels
      Themed playlists
      EPG schedule data
    How to use
      Paste URL in player
      Browse channels
      Use the API
    Tech
      TypeScript
      GitHub Actions
      m3u format
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Load the master playlist into VLC or Kodi to watch free live TV channels from dozens of countries.

USE CASE 2

Filter country-specific or category playlists to build a regional streaming app.

USE CASE 3

Use the companion API to programmatically list and search available channels.

USE CASE 4

Embed a live TV channel list into a media player app without scraping streams yourself.

What is it built with?

TypeScriptGitHub Actionsm3u

How does it compare?

iptv-org/iptvfirecrawl/firecrawlclash-verge-rev/clash-verge-rev
Stars115,965115,952116,117
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasyeasy
Complexity1/52/53/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

No installation needed, paste the playlist URL into a compatible video player like VLC and you're watching immediately.

Released under Creative Commons Zero, effectively public domain, you can use it for any purpose with no 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
I want to add a live TV channel list to my media player app using the iptv-org m3u playlist. Show me how to fetch and parse the master playlist URL in JavaScript and display the channel list.
Prompt 2
Using the iptv-org/iptv playlist, write a Python script that filters channels by country code and saves them to a new m3u file.
Prompt 3
I'm building a streaming dashboard. Show me how to use the iptv-org API to search for channels by name and get their stream URLs.
Prompt 4
Help me set up Kodi with the iptv-org master playlist URL so I can browse live TV channels from multiple countries.
Prompt 5
Write a Node.js script that reads the iptv-org m3u playlist, groups channels by category, and outputs a summary of available genres.

Frequently asked questions

What is iptv?

A community-maintained collection of publicly available live TV stream links from around the world, packaged into m3u playlist files you can load into any compatible video player.

What language is iptv written in?

Mainly TypeScript. The stack also includes TypeScript, GitHub Actions, m3u.

What license does iptv use?

Released under Creative Commons Zero, effectively public domain, you can use it for any purpose with no restrictions.

How hard is iptv to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is iptv for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub iptv-org on gitmyhub

Verify against the repo before relying on details.