whatisgithub

What is iptv?

joevess/iptv — explained in plain English

Analysis updated 2026-06-24

10,285Audience · generalComplexity · 1/5Setup · easy

In one sentence

A collection of regularly updated M3U8 playlist files for watching live Chinese television, covering CCTV national channels, provincial satellite channels, and regional local channels.

Mindmap

mindmap
  root((joevess/iptv))
    What it does
      Live Chinese TV playlists
      M3U8 format files
      Regular updates
    Channels covered
      CCTV national
      Provincial satellite
      Regional local
    Variants
      National and satellite only
      Full with local channels
      Backup stream sources
    Access
      Speed mirror inside China
      Direct GitHub link
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 M3U8 playlist file into a media player app like VLC or Kodi to watch live Chinese TV channels

USE CASE 2

Access CCTV and provincial satellite channels using the direct GitHub link from outside China

USE CASE 3

Use the backup-stream playlist variant to keep channels playing when primary stream sources go offline

USE CASE 4

Subscribe to just national and satellite channels or include regional local channels depending on your needs

What is it built with?

M3U8

How does it compare?

joevess/iptvwix/react-native-calendarsis-a-dev/register
Stars10,28510,28210,281
LanguageTypeScriptJavaScript
Setup difficultyeasyeasyeasy
Complexity1/52/51/5
Audiencegeneraldeveloperdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires an M3U8-compatible media player such as VLC, Kodi, or a dedicated IPTV app, no software installation from this repo is needed.

So what is it?

This repository, documented entirely in Chinese, provides regularly updated playlist files for watching live Chinese television over the internet. The playlists use the M3U8 format, which is a standard text file that tells video player apps where to find a live video stream. You load one of these files into a compatible app and it shows you a list of channels you can tune into, much like a digital TV guide that actually opens the channel when you tap it. The channels covered include national broadcasters such as CCTV (the central state television network) and satellite channels from various Chinese provinces. The repository offers several playlist variants: one covering only national and satellite channels, and one that also includes regional local channels. There are also versions with backup stream sources included, in case the primary stream for a channel goes offline. Two sets of links are provided: one that routes through a speed mirror inside China for faster access within the country, and one that connects directly to the raw GitHub file. Both point to the same playlist content. The README is brief. It lists the playlist links, notes two update dates in early 2024, and thanks visitors for their support. The author asks anyone with high-quality stream sources to share them privately so they can be added to future updates. The README does not explain how to set up a player or how the streams are discovered and tested.

Copy-paste prompts

Prompt 1
How do I open an M3U8 playlist file in VLC to watch live Chinese IPTV channels from the joevess/iptv repository?
Prompt 2
Write me a Python script that reads the M3U8 playlist from joevess/iptv and checks which channel stream URLs are currently online
Prompt 3
How do I add the joevess/iptv M3U8 playlist to the Kodi media center app on my TV box to browse Chinese channels?

Frequently asked questions

What is iptv?

A collection of regularly updated M3U8 playlist files for watching live Chinese television, covering CCTV national channels, provincial satellite channels, and regional local channels.

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 → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.