> 📌 **项目地址**:[iptv-org/iptv](https://github.com/iptv-org/iptv) | ⭐ 129,545 颗星 | 🔧 TypeScript | 📜 未标注
## 这个仓库不存视频,只存链接
`iptv-org/iptv` 是一个 GitHub 仓库,目前有 **12.9 万星**。它的唯一作用是维护一份 `.m3u` 格式的播放列表,每条记录都是用户提交的、认为版权方已公开的直播流 URL。项目每天通过 GitHub Actions 自动检测这些链接(仅检查 TCP 连接是否可达,不测带宽和稳定性),然后部署到 GitHub Pages 上。
主播放列表地址直接写在 README 中:
“`
https://iptv-org.github.io/iptv/index.m3u
“`
把它粘贴到 VLC、Kodi、PotPlayer 等支持直播流的播放器,就能打开。我试了几条,加载速度取决于链接来源,有些秒开,有些转圈后失败。
## 先找子列表,别直接用主列表
主列表包含所有频道,条目过万,直接打开会等待很久。项目专门维护了一个 `PLAYLISTS.md` 文件,里面按国家、语言、类型列出了几十个子列表。每个子列表是单独的 `.m3u` 文件,内容更聚焦。
例如你想看日本公共电视(NHK、TBS 等),找到 `japan.m3u` 复制链接给播放器,体验远好于主列表。建议:**优先去 `PLAYLISTS.md` 里找子列表**。
## 四个仓库,一个生态
README 关联了四个独立仓库,各司其职:
– **iptv-org/database**:存储所有频道的元数据(名称、国家、语言、分类、台标)。播放列表基于这些数据自动生成。如果发现频道信息有误(比如台标不对、国家分错),要去这个仓库提 issue。
– **iptv-org/iptv**(本仓库):每天从 database 拉数据,生成并部署 `.m3u`。检测脚本只验证 TCP 连通性,不保证实际可播放。
– **iptv-org/epg**:提供电子节目指南(EPG)的抓取工具,输出 XMLTV 格式。想看某个频道当前播什么节目,需要自己跑工具,生成 XML 再喂给播放器。
– **iptv-org/api**:RESTful API,可程式化查询频道(按国家、语言、分类)。适合开发者搭建播放器前端或筛选工具。
这四个仓库构成了完整链路:数据录入 → 列表生成 → 分发 → 节目信息 → 查询接口。
## 法律层面:只收集链接,不存内容
README 有一段法律说明,核心事实如下:
– 仓库只保存用户提交的、认为版权方已公开的直播流 URL。
– 不存储任何视频文件,也不提供下载。
– 如果某个链接侵犯了你的版权,可以开 issue 要求移除。但移除链接不会删除视频本身——视频托管在第三方服务器,你需要联系那个服务商。
– GitHub 不接受针对链接的 DMCA 通知,因为链接本身不复制内容,不直接侵权。
简言之:项目是链接索引,不是内容平台。版权问题通过 issue 协商。
## 12.9 万星从哪来
不是因为它提供的源稳定——网络流随时可能失效。也不是因为它代码写得漂亮——仓库本身就是一个自动生成的播放列表集合。它的价值在于:**把全球公开的电视流做了系统化的分类和编排**。你不需要自己去搜索引擎扒链接,直接拿来就能用。虽然质量参差不齐,但作为聚合索引,它省去了大量手动收集的时间。
它是索引,不是源。