网上的直播源列表有很多,但大多已经失效:一个 m3u 里几十上百条,能播的可能只有几条,还得一条条去试。
这个小工具就干一件事:把若干个公开的直播源列表抓下来,合并去重,实测哪些真的能播、画质到底多少,然后挑出最好的一条,导出成一个干净的 M3U。导出的文件丢给 PotPlayer / VLC / IPTV 播放器 / 电视盒子都能直接用。
它自己不提供、不存储、不转发任何直播内容,只是把公开可访问的链接整理一遍、测一测(见 合规声明)。
⚠️ 用之前请看清楚这三句
- 本程序不含任何节目内容,只整理别人公开发布的链接;能不能播、内容是否合规,取决于你所在地区和那些来源本身。
- 它不解除任何付费、加密、鉴权限制,也不提供"看某个频道"的服务——它只回答"这条链接此刻通不通、码率多少"。
- 请自行确认当地法律法规与来源授权,仅供个人自用;整理结果不要用于公开播放、转播、再分发或售卖。如果不确定某个来源,直接在「设置 → 数据源」里关掉它(可以全部关掉,只用你自己的列表)。
| 步骤 | 做什么 |
|---|---|
| ① 下载 | 去 Releases 拿 LiveIPTV.exe,双击即可(单文件,免安装)。发行页上的附件名是 LiveIPTV.exe,和本机打包出来的 LIVE直播源.exe 是同一个程序,改不改名都能跑 |
| ② 更新 | 首次启动会自动跑一次体检;浏览器自动打开控制台 http://127.0.0.1:8899 |
| ③ 导出 | 勾选想要的频道(或点「全选」)→ 点「保存 M3U」→ 把生成的 直播源.m3u 拖进播放器 |
GitHub 的发行版附件在国内经常只有几十 KB/s(13 MB 的包要十几分钟,中途断了还得重来)。 下载不动就换镜像,装的是同一份字节(下完可以核对 sha256):
| 通道 | 地址 |
|---|---|
| GitHub 直连 | https://github.com/kele551/LiveIPTV/releases/download/v1.4.4/LiveIPTV.exe |
| 镜像一(gh-proxy) | https://gh-proxy.com/https://github.com/kele551/LiveIPTV/releases/download/v1.4.4/LiveIPTV.exe |
| 镜像二(ghfast) | https://ghfast.top/https://github.com/kele551/LiveIPTV/releases/download/v1.4.4/LiveIPTV.exe |
- 文件名保持
LiveIPTV.exe,下完直接双击替换旧的即可(数据在%LOCALAPPDATA%\LIVE直播源,不会丢)。 - 本版 sha256:
14cb7deb6a2b41d57bb29633d9cf7bd8ac4debd8c6498d76ef42025ab6717636(13,280,683 字节)。 下完可以自己核一下,对不上就是没下全,重下即可。 - 程序自己的「下载并升级」也走镜像 + 多地址重试,不用你手动挑。
下次打开直接用上次的结果(默认每 6 小时自动更新一次,可关)。
抓取 9 个公开源 → 按频道名合并去重 → 按源实测可用率排序
↓ ↓
每个地址只测一次(去重) → 连通性 + 是否返回网页 → 拉一段真实分片测速
↓ ↓
每个频道挑一条最好的(画质优先、再看速度) → 写 M3U(UTF-8 BOM,播放器不挑)
几个关键点:
- 同一地址只测一次。不同源里大量重复地址,去重后要探测的数量能少一半以上。
- 按源的可信度排序。先抽样 20 条算出每个源「大概有几成能播」,能播的源优先用,不行的源只留一条兜底。
- 上次在用的地址优先复测。日常更新只复测上一轮真能播的那些地址,其余频道没有可播源时才去探新地址 —— 所以第二次以后的更新明显更快。
- 会认「假直播」。有些地址连得上,但返回的其实是频道网页/中转页,这类一律判失效(也顺手记下来,下次不再访问)。
- 画质是解析视频流实测出来的(v1.4.0 起)。直接解 TS 分片里 H.264 / HEVC 的 SPS、fMP4 的
moov、 MPEG-2 的序列头,拿到真实像素宽高,再按分片字节数 ÷ 时长算真实码率;不是拿主清单里标称的RESOLUTION猜,也不看频道名。实测覆盖率约 97%。 - 判定用两条(用户实测口径):分辨率 ≥1080P 且 码率 ≥2 Mbps 才算清晰;下载吞吐 ≥400 KB/s 才算不卡。 只测到一项时会标出缺的那项("低码率" / "分辨率低"),点开能看到具体数值。
- 「码率不足」这个角标按分辨率分档(2026-11-02 起):4K 要 8 Mbps、1080P 要 2 Mbps、 720P 要 1.2 Mbps、480P 要 0.6 Mbps。以前全场只有一条 2 Mbps 的线,720P/1.5 Mbps 这种正常源被误挂角标、 4K/3 Mbps 的虚标源反而没人管。
- 「正在播出」不用填地址:内置两档节目单——央视官方接口(61 个台 id 一次批量,秒级)与一份公开完整 节目表(往后 5 天、往前 7 天,卫视那批能给到具体剧名)。优先级钉死:你自己填的 XMLTV > 央视官方(给了具体 节目名的)> 公开节目表 > 官方只给的大类词;"请欣赏××卫视精彩节目""敬请期待"这类占位档一律不用。 抓取都在后台线程,界面只读内存缓存,首屏不受影响;抓不到就显示「—」,其它功能照常。
- 台标自带离线库:随包 394 张(约 4 MB,按实际显示尺寸存),第一次打开就有图,不用等从 GitHub 拉;
本地没有的台会去台标站补(
v.999.team,约 4 万枚,简繁两种写法都试),补到就存进本地库。 透明的白字台标垫深色底显示,央视那批不会再"白字压白底看不见";同一张图挂在多个不相干的台上会被拦下, 宁可显示名字方块也不显示错标(v1.4.1 起)。
控制台就一页:
- 顶部:状态、进度、「立即更新」「设置」「退出」
- 四个数字:可用频道 / 在线直播源 / 港澳台 / 上次更新
- 中间:搜索、按分组筛(央视 / 卫视 / 港澳台 / 地方台 …)、按画质筛(4K / 1080P / 高清 / 仅港澳台 / 仅可用)
- 底部:已选数量、保存目录、文件名、「保存 M3U」「打开目录」
快捷键:Ctrl+S 保存、Ctrl+F 搜索、Esc 关弹窗。
右下角托盘图标:左键打开控制台,右键菜单有「打开控制台 / 立即更新频道 / 打开 M3U 所在文件夹 / 退出程序」;每次更新完会弹一条气泡告诉你结果。
内置的公开源分三类(国内聚合 / 港澳台 / 可选国际台),默认只开下面这些 (可用率是 2026-11-02 在本机实测抽样,会随网络和时间变化):
| 源 | 覆盖 | 抽样可用 | 默认 |
|---|---|---|---|
| 精选源(内置人工核对,走源码不联网) | 央视、卫视、港澳台 | 10/17 | ✅ |
best-fan·cn_all.m3u8 |
国内聚合 | 14/20 | ✅ |
akiralereal·IPTV.m3u |
国内为主 + 少量海外体育 | 14/14 | ✅ |
CCSH·全量源 live.m3u |
央视、卫视、港澳台、地方台 | 8/20 | ✅ |
| Guovin·IPTV-API | 国内为主 | 7/20 | ✅ |
| ChinaIPTV·自动更新 | 央视、卫视为主 | 3/20 | ✅ |
| iptv-org(中国 / 香港 / 台湾 / 澳门) | 境外整理的国内与港澳台 | 2/20、0/1、2/10、0 条 | ✅ |
| YanG·Gather | 国内聚合 | 全量 123 条 0 条出画面 | ❌ 默认关 |
CCSH·平台源 live_platforms.m3u |
是网络直播间清单,不是电视台 | — | ❌ 默认关 |
| kelvin(旧列表) | 香港 | 0/15 | ❌ 默认关 |
| epg.pw(港/澳/台) | 港澳台 | 1/5、7/17、0 条 | ❌ 默认关 |
YanG·Gather 的那份列表里,咪咕要签名 URL、ttvb 的代理已 404,全量 123 条实测一条都出不了画面, 所以默认关掉(老配置升级时会替你关一次,之后你自己勾选照样算数)。 epg.pw 那几份列表里的流都指向同一个中转域名,本机连不上,所以默认关掉;想试可以在「设置 → 数据源」里重新打开。 抓取时会自动走
jsdelivr/gh-proxy这类公开 CDN 镜像(原地址连不上时才会用),你也可以自己换。
| 分组 | 项 |
|---|---|
| 更新 | 自动更新间隔、每个频道保留几条备用、节目单(内置,也可填自己的 XMLTV 地址)、保存位置、是否保留标清、启动时是否打开网页 |
| 程序 | 托盘图标、开机自启、计划任务(后台定时更新)、检查新版本、必须校验签名、自动下载新版本、升级源地址、检查间隔 |
| 数据源 | 每个源的开关、状态点、抓到的条数、抽样可用率 |
「计划任务」注册的是 LIVE直播源自动更新,用它可以在不开窗口的情况下定时跑一次(托盘和计划任务二选一,一般用托盘就够了)。
- 升级源是一份
version.json+ 一份version.json.sig。 - 程序内置 Ed25519 公钥,每次检查更新都会验签;签名对不上或没有签名,一律拒绝升级(可在设置里关掉,但不建议)。
- 下载完的新版本还会再核对
sha256和字节数,三样都过才提示你替换。 - 因为程序是单文件 exe、运行时无法覆盖自己,新版本会下载到数据目录,提示你手动替换(或按提示操作)。
私钥不随仓库分发,签名流程见 CODE_SIGNING_POLICY.md。
导出的 m3u 播放器不认?
文件是 UTF-8 带 BOM 的 #EXTM3U,PotPlayer、VLC、MX Player、Kodi、各类 IPTV 盒子都能直接读;如果播放器要求 http 链接,可以把文件放到本地 http 服务再填地址。
为什么有些频道没出现?
只输出「实测能拉出画面」的频道。判失效的三种情况:连不上、返回的是网页、能连上但拉不到数据。想放宽可以把「备用源数」调大,或在设置里关掉「保留标清」的限制。
为什么更新有时候要一两分钟?
第一轮要把几百上千个地址都测一遍;之后是增量更新,只复测上一轮能用的地址,一般快得多。也可以在设置里调低「并发探测数」、调小「备用源数」来缩短时间。
杀软报毒?
单文件 Python 打包的 exe 常被启发式误报。程序只做两件事:访问你启用的那些公开列表地址、把结果写进自己的数据目录 %APPDATA%\LIVE直播源。源码完全公开,可自行 pyinstaller 编译。
端口被占用?
默认 8899,被占会自动往后找 10 个;地址会打印在日志和数据目录里。
# 需要 Python 3.9+,只用标准库,不用装任何第三方包
python LIVE直播源.py # 打开控制台(默认 http://127.0.0.1:8899)
python LIVE直播源.py --once # 只更新一次就退出(适合计划任务)
python LIVE直播源.py --no-tray --no-browser --port 9000打包:
python build_exe.py # 产物在 builds/v<版本>/LIVE直播源.exe(打包前自动过一致性检查)
python tools/check_page.py --strict-src # 自检:页面与 _page.html 一致、src 未漂移、语法能过
python tests/test_logic.py # 判据单测(缓存守卫、统计口径)数据目录:默认 %APPDATA%\LIVE直播源;设环境变量 LIVE_DATA 可以指到别处(便携 / 测试用)。
- 免费、无广告、不收费;不采集、不上传任何用户数据:没有账号系统、没有统计上报、没有广告,运行数据只写本机数据目录。
- 程序不含任何直播内容,不存储、不转发、不二次分发;只整理公开可访问的链接并做可用性测试。
- 所有频道、台标、节目内容的权利归各自权利人;本工具与任何电视台、平台、运营商没有隶属关系,也不代表其认可。
- 内容来自第三方公开列表,其合法性、稳定性、画质不由本工具保证;请遵守所在地法律法规,仅作个人学习与自用。
- 权利人若认为某个来源不宜被整理,可通过 Issues 告知,我会把该来源从默认列表里移除。
完整说明见 COMPLIANCE.md。
零第三方依赖:只用 Python 标准库(http.server、urllib、concurrent.futures、ctypes 等)。
Ed25519 验签为自行实现的 _ed25519.py(RFC 8032 参考实现思路,MIT)。
本项目以 MIT 许可发布,Copyright (C) 2026 HaiFeng (kele551)。
如果它帮你省了点折腾时间,可以请我喝杯咖啡 ☕ —— 完全自愿,不影响任何功能。
作者 海风(kele551) · github.com/kele551/LiveIPTV

