Guovin/iptv-api

Public

⚡️ IPTV直播源自动更新工具:自动采集、校验、测速并生成可播放结果,支持 M3U/TXT/API 输出、自定义频道、IPv4/IPv6、Docker、GitHub Actions、CLI 与 GUI 多端部署

  • Stars25.9k+143 tuần này
  • Forks7.6k
  • Watchers993
  • Issues1
  • Ngày tạo04/02/2024
  • Cập nhật gần nhất14/10/2026
  • Ngôn ngữPython
  • Giấy phép—
README.md51.0 KBRaw
IPTV-API logo

IPTV-API

⚡️IPTV直播源自动更新工具,支持自动采集、多源聚合、可用性校验、测速筛选与播放列表生成。可通过丰富配置自定义频道结果,并以 M3U、TXT 或 API 接口形式输出,导入播放器即可观看。

Guovin%2Fiptv-api | Trendshift Guovin%2Fiptv-api | Trendshift Star History Rank

English | 中文

IPTV-API 新版桌面端界面
🌓 切换显示模式 IPTV-API 新版桌面端另一主题界面
Windows / macOS 桌面 GUI · 界面直观,操作更高效
目录

赞助商

赞助商 服务介绍
Helodata

Helodata 全球代理网络

Helodata 提供全球代理基础设施,覆盖 195+国家和地区,拥有8000万+ 合规授权住宅 IP,并支持住宅、ISP、移动及数据中心代理等,为 AI、爬虫与自动化应用提供稳定可靠的数据访问。使用优惠码 iptvapi 可享专属折扣。
IPWO

IPWO 住宅代理网络

IPWO 提供稳定的住宅代理网络,适用于公开数据采集、接口调试、自动化测试与多地区访问验证等合规场景。支持 HTTP / HTTPS / SOCKS5,优惠码:0105。请在合法授权并遵守目标站点条款的前提下使用。

成为赞助商

核心特性

功能 支⁠持⁠状⁠态 说明
自⁠定⁠义⁠模⁠板 ✅ 生成自己想要的频道菜单
频⁠道⁠别⁠名 ✅ 已收录 2,769 个频道、7,254 条别名(含 48 条正则);自动归一化并匹配名称差异
多⁠源⁠聚⁠合 ✅ 本地源、订阅源(支持设置UA,识别无效地址并自动停用)
推⁠流 ✅ 改善弱网播放体验,支持浏览器直接播放,自动转码适配
回⁠放⁠类⁠接⁠口 ✅ 回放类接口的获取与生成
EPG ✅ 获取并显示频道预告内容
频⁠道⁠台⁠标 ✅ 自定义频道台标,支持本地添加或远程库
测⁠速⁠验⁠效 ✅ 获取延迟、速率、分辨率、帧率,过滤无效接口,支持实时输出结果
播⁠放⁠截⁠图 ✅ 可选自动截图,辅助验证频道内容,支持 GUI 预览与批量刷新
广⁠告⁠过⁠滤 ✅ 自动识别并过滤无信号/广告等循环占位源
高⁠级⁠偏⁠好 ✅ 速率、分辨率、黑/白名单、归属地与运营商自定义过滤
结⁠果⁠管⁠理 ✅ 结果分类存储与访问、日志记录、未匹配频道记录、统计分析、冻结过滤/解冻回归、数据缓存
定⁠时⁠任⁠务 ✅ GUI、命令行与 Docker 可定时或间隔执行,不作用于 GitHub Actions
暂⁠停⁠与⁠继⁠续 ✅ 桌面端更新过程中可暂停,并从当前进度继续
多⁠平⁠台⁠部⁠署 ✅ 工作流、命令行、GUI 软件、Docker (amd64/arm64/arm v7)
更⁠多⁠功⁠能 ✨ 详见配置参数章节

配置

Note

以下配置项位于 config/config.ini 文件中,支持通过配置文件或环境变量修改,保存后重启即可生效。也可查看独立的配置参数文档。

Tip

生成结果质量取决于数据源与网络环境等因素,请合理调整配置参数以获取更符合需求的结果。

点击展开查看配置参数
配置项 描述 默认值
open_update 开启更新,用于控制是否更新接口,若关闭则所有工作模式(获取接口和测速)均停止 True
open_unmatch_category 开启未匹配频道分类,未匹配 source_file 的频道会进入该分类并直接写入结果,不参与测速 False
open_empty_category 开启无结果频道分类,自动归类至底部 False
open_update_time 开启显示更新时间 True
open_url_info 开启显示接口说明信息,用于控制是否显示接口来源、分辨率、协议类型等信息,为 $ 符号后的内容,播放软件使用该信息对接口进行描述,若部分播放器(如 PotPlayer)不支持解析导致无法播放可关闭 False
open_epg 开启 EPG 功能,支持频道显示预告内容 True
open_subscribe_epg 开启从订阅源 m3u 头部 url-tvg/x-tvg-url 自动提取 EPG 地址,并入 EPG 源一起合并,无需手动维护 config/epg.txt;epg.txt 源优先,订阅源仅补充未覆盖频道;需 open_epg = True

Nội dung README thuộc về Guovin và cộng đồng đóng góp, giấy phép Không có giấy phép. Nguồn: github.com/Guovin/iptv-api