chuiziyao/wushuang-iptv
多媒体与设计抓取并验证自家已订阅的 IPTV 组播源,一键导出 M3U 播放列表,供电视、手机、平板播放。
项目介绍
无双IPTV 面向已经付费订阅家庭 IPTV 的用户:把机顶盒里的组播直播地址抓出来、逐个验证能正常收流,再导出成 M3U 播放列表,让家里的电视、手机、平板都能看。
流程分四步。接线向导根据你的硬件情况生成插拔网线步骤和拓扑图,覆盖傻瓜交换机、路由器 IPTV 口 / VLAN 绑定、已桥接合并网络三种场景。抓包分析使用 Windows 自带的 pktmon,不需要 Wireshark 或 Npcap,换台时自动发现组播地址并去重过滤。频道验证原生解析 MPEG-TS 的 PAT/PMT/SDT/SPS,不依赖 ffmpeg,自动命名并标出编码、分辨率和可用性。生成 M3U 时同时产出 udp:// 组播直连和 http:// udpxy 转发两种格式。
全国参考库覆盖 31 省 × 电信/联通/移动/广电,可按省份和运营商载入,支持在线更新和离线导入,但它只是候选地址,各地运营商调整频繁,以本机实测为准。工具内置等价于 udpxy 的转发服务,把组播转成 HTTP 单播,方便 Wi-Fi 设备播放;生成后还能通过 SMB 或 WebDAV 一键推送到 NAS,配合 Tvheadend/udpxy 做 7×24 转发。v2.1 新增的 WushuangIPTV-CLI.exe 提供无界面命令行模式,输出 JSON 和退出码,可被 AI 工具调用。
快速使用
Windows 10 1809 及以上,从 Releases 下载 WushuangIPTV.exe,双击运行,程序会自动请求管理员权限(抓包需要)。
- ① 接线向导:选你的场景,照步骤接线。
- ② 抓包分析:开始抓包 → 在机顶盒上逐个换台,每台停 3~5 秒 → 停止并分析 → 加入频道列表。已桥接或免交换机场景可跳过抓包,直接在 ③ 载入参考库。
- ③ 频道验证:选组播网卡,验证全部频道。
- ④ 生成 M3U:选输出目录保存,可选一键推送到 NAS。
- 用 VLC、Kodi、DIYP 或配套电视 APK 打开播放列表。
命令行方式从 Releases 下载 WushuangIPTV-CLI.exe,在终端执行:
WushuangIPTV-CLI.exe info
WushuangIPTV-CLI.exe verify --province 浙江 --carrier 电信 --out verified.json
WushuangIPTV-CLI.exe m3u --channels verified.json --outdir D:\iptv
stdout 输出单个 JSON 结果,stderr 输出 JSONL 进度;退出码 0 成功、1 失败、2 参数错误、3 需要管理员。只有 capture 抓包命令需要管理员权限。首次运行若弹出 Windows 防火墙提示,选择「允许访问」。完整参数见项目的 CLI 使用说明,AI 工具入口见 AGENTS.md。
平台与版本
Windows 是唯一正式支持的平台,当前为 v2.1.0。Linux x64、macOS(Intel / Apple Silicon)和鸿蒙 PC(HarmonyOS NEXT 2in1)都是 v2.1.0-beta 测试版,未做真机测试,在真实 IPTV 环境验证前不要用于生产。Linux 据称已在 WSL Ubuntu 22.04 完成功能验证,macOS 与 Linux 共用 POSIX 代码路径并由 CI 构建覆盖,鸿蒙版已构建出 HAP 但待签名和真机验证。
Linux/macOS 源码运行需要 Python 3.10+ 和 tkinter,抓包需要 tcpdump 并用 sudo。WSL2 默认 NAT 模式收不到物理局域网组播,需要镜像网络模式或真机;macOS 未签名产物首次打开需右键 → 打开。鸿蒙版因系统不给第三方应用原始抓包权限,完全不支持抓包,真实收流需要鸿蒙 PC 真机有线接入 IPTV 网络。
使用约束
本工具仅供个人学习、研究,在自家局域网内自用,接收的是你已付费订阅的 IPTV 内容。项目明确要求不要公开分享或售卖抓取的源、不要搭建公网服务供他人观看、不要克隆机顶盒账号获取未付费业务,转发服务也不得映射到公网。参考库按需从社区仓库 xisohi/CHINA-IPTV 下载而非内置,候选地址需本机验证。项目以 MIT 许可证发布。
HotRepo 点评
这是一个边界清晰的小工具,配套文档却相当完整:每个步骤都有截图,移动「四口盲插」这类特殊情况有专项方案,跨平台差异和 CLI 协议也单独成文。HotRepo 在 2026-11-19 的 Python 新项目记录中首次收录它,当时 104 星,1 小时窗口净增 3 星;这只是单次短窗口观测,不足以说明趋势。对准备上手的人来说,主要需要留意交付方式:官方推荐路径是运行预编译的 Windows 可执行文件和仓库内的 APK,运行前值得自行确认二进制与源码的对应关系。
配套 APK
仓库附带两个安卓安装包:电视版约 1.6 MB,支持 Android 4.0+ 的老电视,带遥控器操作、数字选台和收藏;手机版支持触屏和横屏全屏。填入生成的播放列表地址即可观看。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- iptv-org/iptv把全球公开的直播源整理成现成 M3U 播放列表,让任何播放器直接打开观看。
- anITer/utv面向北京联通 IPTV 的 Android 直播播放器,内置组播代理、MP2/杜比音频与频道巡检。
- fmhyplay/android面向 Android TV 的浏览器与播放器,把用户自行添加的流媒体站点和 IPTV 播放列表交给原生播放器播放。
- AndreyPavlenko/Fermata面向按文件夹整理媒体的 Android 用户,播放音频、视频和 IPTV,而不是围绕媒体库标签设计。
- LibreSpark/LibreTV把多个第三方采集站和 IPTV 播放列表聚合成一个可自托管的私人影视站,负责搜索与播放。