Mindket

IPTV

Newversion 1 · updated
Star144k

Overview

Collects publicly available live TV channels from many countries into playlists that any video player with live streaming can open. Made for viewers and for developers who need channel data.

IPTV is an open-source project on GitHub in the Productivity category, listed by Mindket. It is free. This is version 1, last updated on . Install it from GitHub as its README says. Get Mindket’s setup notes on your Mindket account, as a zip.

At a glance

You need
  • A video player that supports live streaming
  • An internet connection
  • The link to the main playlist, found on the project page
Runs in
  • VLC and other video players that can play live streams
  • Apps listed in the awesome-iptv resource repository
  • Your own code, through the API in its separate repository
Start with
git clone https://github.com/iptv-org/iptv.git
cd iptv

About

What it is

This project is a catalogue of live TV channels from around the world, kept as playlist files. Each entry points to a stream that is already public on the web. The repository holds no video, only the links people have submitted.

Who it suits

Anyone who wants live TV channels in a video player, and developers who need channel data for their own apps.

IndustryWho uses itHow they use itExample
Media and entertainmentHome viewersLoad a playlist into a media player and press Open to watch live channelsOpening the main playlist in a player on a laptop
Software developmentApp buildersRead channel details through the separate API and database repositoriesFilling a channel picker inside a small viewing app
Broadcast technologyProgram guide buildersRun the EPG utilities that download program guides for most channelsShowing program times beside a channel list
EducationLanguage learnersWatch live channels from other countries to hear the language spokenTuning to a channel in the language being studied
Open sourceContributorsReport wrong channel data and read the contributing guide before sending changesOpening an issue about an incorrect channel entry

Anyone who does not watch live streams or build around channel data can skip it.

Where to use it

  • VLC and other video players that can play live streams
  • Apps listed in the awesome-iptv resource repository
  • Your own code, through the API in its separate repository
Use caseWhoWhat they get back
Watch live TVViewersA list of channels that play live inside the player
Try other playlistsViewersMore playlists, linked from a separate playlists file in the repository
Add program guidesHobbyistsElectronic program guide data for most channels
Build with channel dataDevelopersChannel records from the database and API documentation in its own repository

How to set it up

  • A video player that supports live streaming
  • An internet connection
  • The link to the main playlist, found on the project page
  1. Install a video player that can open live streams.
  2. Copy the link of the main playlist from the project page.
  3. Paste it into the player's option for opening a network stream.
  4. Press Open.

Run these in a terminal:

# Copy the project to your computer
git clone https://github.com/iptv-org/iptv.git
# Go into its folder
cd iptv

How to use it

Day to day, you open the playlist in your player and pick a channel. More playlist links sit in a separate file in the repository, and a FAQ file answers common questions. The project splits its other jobs across the parts below.

ToolWhat it does
PlaylistsChannel lists you paste into a player, with the main one holding every channel
EPGUtilities that download electronic program guides for most channels
DatabaseHolds all channel data, and is the place to report errors in it
APIDocumented in a separate repository for developers

Example

Say you want live channels from another country. You paste the main playlist link into a media player, press Open and pick a channel from the list. The channel then plays live in the player.

For newcomers and experts

A playlist is a plain text file in m3u format that lists channels and where their streams live. Your player reads it and shows the channels as a list. Start by pasting the main playlist link into a player and opening it.

Under the hood, the playlists draw on one channel database kept in a separate repository, while the EPG utilities and the API sit in two more. The project only links to streams and has no control over what sits behind them. Removing a link from a playlist does not take the content off the web.

  1. Contributors submit links to public streams
  2. Channel data lives in the database repository
  3. Playlists are built from that data
  4. You paste a playlist link into your player
  5. The player plays the live stream

Good to know

  • No video files are stored here, only links that contributors submitted.
  • Copyright holders can ask for a link to be removed by opening an issue.
  • The maintainers can only remove a link. To take content off the web, you contact the web host that serves it.
  • Program guides, channel data and the API live in other repositories.
  • License: the listing names the Unlicense, and the README shows a CC0 badge.

README and files

README

IPTV

Collects publicly available live TV channels from many countries into playlists that any video player with live streaming can open. Made for viewers and for developers who need channel data.

Made by iptv-org on GitHub. These notes are Mindket's, written from its README; the project's own files and license are in its repository.

About

What it is: This project is a catalogue of live TV channels from around the world, kept as playlist files. Each entry points to a stream that is already public on the web. The repository holds no video, only the links people have submitted.

Who it suits: Anyone who wants live TV channels in a video player, and developers who need channel data for their own apps.

Industry | Who uses it | How they use it | Example
Media and entertainment | Home viewers | Load a playlist into a media player and press Open to watch live channels | Opening the main playlist in a player on a laptop
Software development | App builders | Read channel details through the separate API and database repositories | Filling a channel picker inside a small viewing app
Broadcast technology | Program guide builders | Run the EPG utilities that download program guides for most channels | Showing program times beside a channel list
Education | Language learners | Watch live channels from other countries to hear the language spoken | Tuning to a channel in the language being studied
Open source | Contributors | Report wrong channel data and read the contributing guide before sending changes | Opening an issue about an incorrect channel entry

Anyone who does not watch live streams or build around channel data can skip it.

Where to use it:

  • VLC and other video players that can play live streams
  • Apps listed in the awesome-iptv resource repository
  • Your own code, through the API in its separate repository
Use case | Who | What they get back
Watch live TV | Viewers | A list of channels that play live inside the player
Try other playlists | Viewers | More playlists, linked from a separate playlists file in the repository
Add program guides | Hobbyists | Electronic program guide data for most channels
Build with channel data | Developers | Channel records from the database and API documentation in its own repository

How to set it up:

  • A video player that supports live streaming
  • An internet connection
  • The link to the main playlist, found on the project page
  1. Install a video player that can open live streams.
  2. Copy the link of the main playlist from the project page.
  3. Paste it into the player's option for opening a network stream.
  4. Press Open.

How to use it: Day to day, you open the playlist in your player and pick a channel. More playlist links sit in a separate file in the repository, and a FAQ file answers common questions. The project splits its other jobs across the parts below.

Tool | What it does
Playlists | Channel lists you paste into a player, with the main one holding every channel
EPG | Utilities that download electronic program guides for most channels
Database | Holds all channel data, and is the place to report errors in it
API | Documented in a separate repository for developers

Example: Say you want live channels from another country. You paste the main playlist link into a media player, press Open and pick a channel from the list. The channel then plays live in the player.

For newcomers and experts: A playlist is a plain text file in m3u format that lists channels and where their streams live. Your player reads it and shows the channels as a list. Start by pasting the main playlist link into a player and opening it.

Under the hood, the playlists draw on one channel database kept in a separate repository, while the EPG utilities and the API sit in two more. The project only links to streams and has no control over what sits behind them. Removing a link from a playlist does not take the content off the web.

Contributors submit links to public streams
Channel data lives in the database repository
Playlists are built from that data
You paste a playlist link into your player
The player plays the live stream

Good to know:

  • No video files are stored here, only links that contributors submitted.
  • Copyright holders can ask for a link to be removed by opening an issue.
  • The maintainers can only remove a link. To take content off the web, you contact the web host that serves it.
  • Program guides, channel data and the API live in other repositories.
  • License: the listing names the Unlicense, and the README shows a CC0 badge.

On GitHub, 14 November 2026

  • Stars: 143,936
  • Forks: 8,585
  • Watching: 2,522
  • Open issues and pull requests: 22
  • Language: TypeScript
  • License: Unlicense
  • Topics: iptv, m3u, playlist, streams, tv

Links

Get the code

git clone https://github.com/iptv-org/iptv.git

Then follow the setup in its README. Nothing in this kit runs by itself.

Files
README.md  5 KB

1 file, 5 KB, downloaded as a zip.

What’s new

  • Version 1 · 2026-11-14

Reviews

No ratings yet

Write a review

No reviews yet.

What people say

Posts and comments that name this project on Hacker News, Bluesky, X, Reddit, Facebook and YouTube, found by a weekly search and on Trendshift. Mindket doesn’t write or check them. Open one to read it where it was posted.

burundi_coffeeDMCA Takedown of iptv-org/iptv on GitHub85 points · 74 replies@rainyxiejiaze成品在这儿,自取 👇 📦 下载(v1.6,手机+电视通用): https://t.co/zsRy6QvZf5r/vitahacks[DESKTOP TOOL] Bonsai: trim huge IPTV playlists down to what VitaIPTV can actually playgslinGoogle Asked to Deindex Iptv-Org, the Largest Free IPTV Repo15 points@gilles_acIt's a media player that connects to your Emby Server. But it also support IPTV so you can also just load in an M3U and watch tv in a very convenient way! Should i make a companion Server so we don't rely on Emby for that and make all the paid features they have for free?r/PSVitaHomebrewTV Stream on PSVITA !!!paulcarrotyIPTV-org's GitHub database got banned2 points@laogeai电视直播一直有免费路子,只是少有人系统整理。 iptv-org 把全球公开可用的 IPTV 频道按国家、语言、分类整理成列表,每天自动更新,填进支持 M3U 的播放器就能看。十四万颗星。 https://t.co/bo8yLEIYfnr/ps5homebrewProsperoTV – Native IPTV client for PS5 with 12,000+ channelswebererRead this before you buy that TV streaming stickThere are a ton of legitimately free IPTV streams. You can watch them through most media players like VLC without having to download anything shady. https://github.com/iptv-org/iptv@PiracyCentralAll you need is VLC and you can watch the EPL, LaLiga and more + any HD movies with your VLC for $0.00 Download VLC from App Store or Google Playstore Or from https://t.co/NXiM0fIfgB Go to Media > Open Network Stream. Paste a playlist URL https://t.co/qtbPWLrM53 https://t.co/7FCRRqs8jHnclnqqI want to build an OTT app. Where should I start?https://github.com/iptv-org/iptv

Searched

More from Mindket

See all from Mindket

anaksor-ocr

Sokheng · Kit

Reads Khmer and English text from documents, receipts and photos of signs, using a detector for text lines and a recogniser for each line. Suits developers who…

New

Qwen2.5-7B-Instruct as GGUF files in eight quantization sizes, to chat with locally through llama.cpp. For people who want a capable 7.6B model on their own co…

New

ACE-Step 1.5 XL SFT

ACE-Step · Kit

Generates music from text with a 4B diffusion decoder, 50 steps and guidance control, aiming for higher audio quality than the base. For creators with a GPU of…

New

Similar in Productivity

See all in Productivity

Guizang PPT Skill

op7418 · Skill

Skill that makes single-file HTML slide decks, slide illustrations and platform covers in two visual styles, with a presenter mode for rehearsal. For speakers…

New29.8k

Frontend Slides

zarazhangrui · Skill

Builds HTML presentations from scratch or from a PowerPoint file and shows visual style previews to pick from, for people who want web slides with no CSS or Ja…

New32.3k

upscaler

uwg · Kit

Holds a set of image upscaling models gathered from the OpenModelDB community, for people who want to enlarge low-resolution pictures with AI on their own comp…

New