explaingit

iptv-org/awesome-iptv

★ 11,072Audience · generalComplexity · 1/5Setup · moderate

TLDR

A curated list of apps, stream datasets, EPG sources, and developer libraries for watching live TV over the internet (IPTV), organized by platform from web browsers to Apple TV and Roku.

Mindmap

mindmap
  root((awesome-iptv))
    Apps by platform
      Web browser
      Windows and macOS
      Android and iOS
      Smart TV and Roku
    Data sources
      Channel datasets
      EPG program guides
      M3U playlists
    Developer tools
      Playlist parsers
      Playlist validators
    Providers
      Stream services
      Channel directories
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

Things people build with this

USE CASE 1

Find an IPTV player app for your specific device, Windows, Android, Apple TV, Roku, or a web browser.

USE CASE 2

Locate public channel stream datasets organized by country or category to load into your player.

USE CASE 3

Discover developer libraries for parsing, validating, or building tools around M3U playlists and EPG data.

Getting it running

Difficulty · moderate Time to first run · 30min

Finding working streams requires sourcing M3U playlists separately, availability and legality vary by region.

In plain English

IPTV stands for Internet Protocol Television, which means watching live TV channels over the internet instead of through cable or satellite. This repository is a curated collection of tools, apps, services, and data sources that work with IPTV streams. The bulk of the list is apps organized by platform: web browsers, Windows, macOS, Linux, Android phones, iPhones, iPads, Apple TV, Android TV, Roku, Xbox, Apple Watch, Google Chrome, and Docker containers. Each entry links to a player or viewer application that can load and play IPTV channel lists. Many of the apps support a file format called M3U, which is a plain text file containing addresses pointing to live TV streams. Beyond apps, the list also covers providers (services that supply streams), channel datasets (collections of publicly available stream addresses organized by country or category), and EPG sources. EPG stands for Electronic Program Guide, the schedule data that shows what is currently airing and what comes next, similar to the channel guide on a cable box. There is also a section for programming libraries aimed at developers who want to build their own tools that parse, validate, or work with IPTV playlists and schedules. No single application or service is built here, this is a reference list, not runnable code. The project is maintained as part of the iptv-org organization on GitHub, which separately maintains large public playlists of free-to-access channels. This repository is the companion index of resources that help people find and use those streams. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
I want to watch live TV from a specific country using VLC on my Mac. Show me how to load an M3U playlist from the iptv-org channel datasets.
Prompt 2
Build me a simple web app that fetches an M3U playlist and lists channels with a play button, recommend the best player library from awesome-iptv.
Prompt 3
Write a Python script that reads an M3U playlist file and filters it to keep only channels matching a specific country or category tag.
Prompt 4
Which EPG sources from the iptv-org list are compatible with Jellyfin or Plex for displaying a program guide alongside live channels?
Open on GitHub → Explain another repo

← iptv-org on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.