它是 playlist 仓库,不是流媒体服务

只看 star 数,iptv-org/iptv 很容易被误解。它不是 app,不是 media server,也不是付费 IPTV 服务。它是一个大型 M3U playlist 链接仓库,收集公开可访问的直播电视流,让这些链接能被 VLC 等播放器打开,或被其他工具消费。

这个区别很重要。仓库不托管视频文件。它保存的是用户提交的 stream URL 和生成后的 playlist 文件。README 给出一个包含全部频道的主 playlist,也提供按 category、language、country、region 等拆分的列表。它周围的 companion repos 分别处理频道元数据、EPG 数据和 API。

它持续上榜的实际原因很直接:如果你要测试 IPTV player、media-center setup、stream validation tool,或者做公开频道发现,它是少数不用自己建频道库就能立刻使用的数据源。截至 2026-06,这个仓大约有 119,000 stars、6,000 多 forks,issue 流也非常活跃。

怎么用

主 playlist URL 是:

https://iptv-org.github.io/iptv/index.m3u

把这个 URL 粘到支持网络直播流的视频播放器里,然后打开即可。README 用 VLC 做示例,但 playlist 是标准 M3U,许多 IPTV player 和 media-center 工具都能读取。

完整 playlist 只是入口之一。PLAYLISTS.md 还发布了多种分组版本,可以按 category、language、country、region、subdivision、block 或 source 选择。这个能力很实用,因为全量列表太宽。播放器、测试工具或家庭使用场景通常只需要一个更窄的切片。

项目被拆在几个仓里

iptv 仓是 playlist 层,不是整个组织的唯一事实源:

  • iptv-org/database 存频道数据。频道名、logo、language、category 出错时,README 说应去那里报。
  • iptv-org/epg 发布许多频道的 Electronic Program Guide 数据。
  • iptv-org/api 负责 API 文档。
  • iptv-org/awesome-iptv 收集相关 app 和 IPTV 资源。

这种拆分既是优点,也是混淆来源。如果 issue 发错仓,维护者可能会要求你转去别处。如果你要程序化使用,不要抓 README 当 API。应该按需要使用 API repo 或生成后的 playlist 文件。

贡献规则比仓库名更严格

贡献指南的重点是质量控制。一个 stream link 应该稳定、直连、不重复,并且要在常用播放器里至少测试一分钟。Xtream Codes server 链接会被排除,因为它们通常很快失效,维护成本高。broken stream report 也需要有效链接,且要求报告者确认它仍在 playlist 中,并排除只是 geo-blocking 的情况。

所以 issue tracker 里会看到大量 “Add” 和 “Edit” 小票。这个仓更像数据维护队列,而不是传统软件 bug tracker。最近 issue 多数是频道新增、编辑和移除。对这种项目来说这是健康状态,但也意味着用户要接受变动。今天能用的 playlist entry,之后可能失效、消失或变成地区限制。

法律边界

README 里的 Legal 部分在这里尤其重要。项目说自己不存视频文件,只包含维护者认为由版权方公开提供的 stream link。它也提供了版权移除请求模板。

这不等于所有下游使用都没有风险。如果你要把这些 playlist 嵌进产品、重新分发过滤后的列表,或者在商业场景里展示频道,需要自己做合规评估。这个仓的说法更窄:它链接公开 stream URL,并会按流程移除链接。至于底层视频,它托管在别处,仓库维护者无法把源内容从网上删除。

个人测试、VLC 使用、开放工具开发,这个边界足够清楚。任何面向公众的产品,都应把 playlist 当成仍需政策和权利审查的输入数据。

适合什么

适合使用 iptv-org/iptv 的场景:

  • 需要现成的公开直播频道 M3U playlist;
  • 需要按 language、country 或 category 切分 playlist;
  • 需要真实 stream 数据来测试 IPTV player;
  • 需要维护中的 broken stream 和 missing stream issue 流程;
  • 需要配套 EPG 与 API 数据生态。

不适合的场景也很明确:稳定 SLA、授权商业转播、私有频道、VOD、正式支持合同。FAQ 明确说项目不计划加入 Video On Demand。它是社区维护的公开链接索引,不是广播服务商。

star 增长

采样 star 曲线显示,这是一个长期项目,靠周期性关注重新进入趋势,而不是新项目发布。这个形状和仓库本身一致:它从 2018 年就在维护,但当 playlist 需求、播放器测试或公开 stream 讨论升温时,仍会回到 trending。2026 年 6 月 14 日早报里,它以 +46 stars 排第 9。

相关

另一个大型人工维护索引可以看 public-apis。如果你想看它同一期早报里还出现了什么,读 6 月 14 日日报 和 6 月 8 日当周周报。

FAQ

iptv-org/iptv 是什么? 它是一个收集公开直播电视流 M3U playlist 链接的 GitHub 仓库。它不是流媒体 app,也不托管视频文件。

怎么在 VLC 里打开? 在 VLC 的 network stream 入口粘贴 https://iptv-org.github.io/iptv/index.m3u,或者从 PLAYLISTS.md 选择更窄的 playlist。

iptv-org 包含 VOD 吗? 不包含。FAQ 明确说项目不计划把 Video On Demand 加入 playlist。

EPG 数据在哪里? EPG 数据由 iptv-org/epg 仓处理,不是 playlist 仓本身。

我能添加频道吗? 可以,但贡献指南要求提供稳定直连 stream link,先在播放器中验证,确认未重复,避开 Xtream Codes 链接,并使用正确频道 ID。

使用 iptv-org/iptv 合法吗? 仓库声明它只链接公开 stream,不存视频。这不是适用于所有下游场景的法律结论。公开产品和商业使用仍需自己做权利审查。