base on 📺IPTV电视直播源更新工具🚀：✨央视、📡卫视、☘️广东及各省份地方台、🌊港·澳·台、🎬电影、🎥咪咕、🏀体育、🪁动画、🎮游戏、🎵音乐、🏛经典剧场；支持IPv4/IPv6；支持自定义增加频道；支持组播源、酒店源、订阅源、关键字搜索；每天自动更新两次，结果可用于TVBox等播放软件；支持工作流、Docker(amd64/arm64/arm v7)、命令行、GUI运行方式 | IPTV live TV source update tool <div align="center"> <img src="./static/images/logo.png" alt="logo"/> <h1 align="center">IPTV-API</h1> </div> <div align="center">自定义频道，自动获取直播源接口，测速验效后生成可用的结果</div> <div align="center">默认结果包含：📺央视频道、💰央视付费频道、📡卫视频道、🏠广东频道、🌊港·澳·台频道、🎬电影频道、🎥咪咕直播、🏀体育频道、🪁动画频道、🎮游戏频道、🎵音乐频道、🏛经典剧场</div> <details> <summary>具体频道</summary> <div> 📺央视频道: CCTV-1, CCTV-2, CCTV-3, CCTV-4, CCTV-5, CCTV-5+, CCTV-6, CCTV-7, CCTV-8, CCTV-9, CCTV-10, CCTV-11, CCTV-12, CCTV-13, CCTV-14, CCTV-15, CCTV-16, CCTV-17, CETV1, CETV2, CETV4, CETV5 </div> <br> <div> 💰央视付费频道: 文化精品, 央视台球, 风云音乐, 第一剧场, 风云剧场, 怀旧剧场, 女性时尚, 高尔夫网球, 风云足球, 电视指南, 世界地理, 兵器科技 </div> <br> <div> 📡卫视频道: 广东卫视, 香港卫视, 浙江卫视, 湖南卫视, 北京卫视, 湖北卫视, 黑龙江卫视, 安徽卫视, 重庆卫视, 东方卫视, 东南卫视, 甘肃卫视, 广西卫视, 贵州卫视, 海南卫视, 河北卫视, 河南卫视, 吉林卫视, 江苏卫视, 江西卫视, 辽宁卫视, 内蒙古卫视, 宁夏卫视, 青海卫视, 山东卫视, 山西卫视, 陕西卫视, 四川卫视, 深圳卫视, 三沙卫视, 天津卫视, 西藏卫视, 新疆卫视, 云南卫视 </div> <br> <div> ☘️广东频道: 广东珠江, 广东体育, 广东新闻, 广东民生, 广东卫视, 大湾区卫视, 广州综合, 广州影视, 广州竞赛, 江门综合, 江门侨乡生活, 佛山综合, 深圳卫视, 汕头综合, 汕头经济, 汕头文旅, 茂名综合, 茂名公共 </div> <br> <div> ☘️各省份地方台 </div> <br> <div> 🌊港·澳·台: 翡翠台, 明珠台, 凤凰中文, 凤凰资讯, 凤凰香港, 凤凰卫视, TVBS亚洲, 香港卫视, 纬来体育, 纬来育乐, J2, Viutv, 三立台湾, 无线新闻, 三立新闻, 东森综合, 东森超视, 东森电影, Now剧集, Now华剧, 靖天资讯, 星卫娱乐, 卫视卡式 </div> <br> <div> 🎬电影频道: CHC家庭影院, CHC动作电影, CHC高清电影, 淘剧场, 淘娱乐, 淘电影, NewTV惊悚悬疑, NewTV动作电影, 黑莓电影, 纬来电影, 靖天映画, 靖天戏剧, 星卫娱乐, 艾尔达娱乐, 经典电影, IPTV经典电影, 天映经典, 无线星河, 星空卫视, 私人影院, 东森电影, 龙祥电影, 东森洋片, 东森超视 </div> <br> <div> 🎥咪咕直播: 咪咕直播1-45 </div> <br> <div> 🏀体育频道: CCTV-5, CCTV-5+, 广东体育, 纬来体育, 五星体育, 体育赛事, 劲爆体育, 爱体育, 超级体育, 精品体育, 广州竞赛, 深圳体育, 福建体育, 辽宁体育, 山东体育, 成都体育, 天津体育, 江苏体育, 安徽综艺体育, 吉林篮球, 睛彩篮球, 睛彩羽毛球, 睛彩广场舞, 风云足球, 足球频道, 魅力足球, 天元围棋, 快乐垂钓, JJ斗地主 </div> <br> <div> 🪁动画频道: 少儿动画, 卡酷动画, 动漫秀场, 新动漫, 青春动漫, 爱动漫, 中录动漫, 宝宝动画, CN卡通, 优漫卡通, 金鹰卡通, 睛彩少儿, 黑莓动画, 炫动卡通, 24H国漫热播, 浙江少儿, 河北少儿科教, 七龙珠, 火影忍者, 海绵宝宝, 中华小当家, 斗破苍穹玄幻剧, 猫和老鼠, 经典动漫, 蜡笔小新, 漫画解说 </div> <br> <div> 🎮游戏频道: 游戏风云, 游戏竞技, 电竞游戏, 海看电竞, 电竞天堂, 爱电竞 </div> <br> <div> 🎵音乐频道: CCTV-15, 风云音乐, 音乐现场, 音乐之声, 潮流音乐, 天津音乐, 音乐广播, 音乐调频广播 </div> <br> <div> 🏛经典剧场: 笑傲江湖, 天龙八部, 鹿鼎记, 仙剑奇侠传, 西游记, 三国演义, 水浒传, 新白娘子传奇, 天龙八部, 济公游记, 封神榜, 闯关东, 上海滩, 射雕英雄传 </div> </details> <br> <p align="center"> <a href="https://github.com/Guovin/iptv-api/releases/latest"> <img src="https://img.shields.io/github/v/release/guovin/iptv-api" /> </a> <a href="https://www.python.org/"> <img src="https://img.shields.io/badge/python-%20%3D%203.13-47c219" /> </a> <a href="https://github.com/Guovin/iptv-api/releases/latest"> <img src="https://img.shields.io/github/downloads/guovin/iptv-api/total" /> </a> <a href="https://hub.docker.com/repository/docker/guovern/iptv-api"> <img src="https://img.shields.io/docker/pulls/guovern/iptv-api" /> </a> <a href="https://github.com/Guovin/iptv-api/fork"> <img src="https://img.shields.io/github/forks/guovin/iptv-api" /> </a> </p> [English](./README_en.md) | 中文 - [✅ 特点](#特点) - [🔗 最新结果](#最新结果) - [⚙️ 配置参数](#配置) - [🚀 快速上手](#快速上手) - [工作流](#工作流) - [命令行](#命令行) - [GUI软件](#GUI-软件) - [Docker](#Docker) - [📖 详细教程](./docs/tutorial.md) - [🗓️ 更新日志](./CHANGELOG.md) - [❤️ 赞赏](#赞赏) - [👀 关注(更新订阅+答疑交流)](#关注) - [📣 免责声明](#免责声明) - [⚖️ 许可证](#许可证) ## 特点 - ✅ 自定义模板，生成您想要的频道 - ✅ 支持多种获取源方式：组播源、酒店源、订阅源、关键字搜索 - ✅ 接口测速验效，获取延迟、速率、分辨率，过滤无效接口 - ✅ 偏好设置：IPv6、接口来源排序优先级与数量配置、接口白名单 - ✅ 定时执行，北京时间每日 6:00 与 18:00 执行更新 - ✅ 支持多种运行方式：工作流、命令行、GUI 软件、Docker(amd64/arm64/arm v7) - ✨ 更多功能请见[配置参数](#配置) ## 最新结果 - 接口源： ```bash https://ghgo.xyz/raw.githubusercontent.com/Guovin/iptv-api/gd/output/result.m3u ``` ```bash https://ghgo.xyz/raw.githubusercontent.com/Guovin/iptv-api/gd/output/result.txt ``` 或 ```bash https://cdn.jsdelivr.net/gh/Guovin/iptv-api@gd/output/result.m3u ``` ```bash https://cdn.jsdelivr.net/gh/Guovin/iptv-api@gd/output/result.txt ``` - 数据源： ```bash https://ghgo.xyz/raw.githubusercontent.com/Guovin/iptv-api/gd/source.json ``` 或 ```bash https://cdn.jsdelivr.net/gh/Guovin/iptv-api@gd/source.json ``` ## 配置 | 配置项 | 描述 | 默认值 | |:-----------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------|:------------------| | open_driver | 开启浏览器运行，若更新无数据可开启此模式，较消耗性能 | False | | open_empty_category | 开启无结果频道分类，自动归类至底部 | False | | open_filter_resolution | 开启分辨率过滤，低于最小分辨率（min_resolution）的接口将会被过滤 | True | | open_filter_speed | 开启速率过滤，低于最小速率（min_speed）的接口将会被过滤 | True | | open_hotel | 开启酒店源功能，关闭后所有酒店源工作模式都将关闭 | True | | open_hotel_foodie | 开启 Foodie 酒店源工作模式 | True | | open_hotel_fofa | 开启 FOFA、ZoomEye 酒店源工作模式 | True | | open_keep_all | 开启保留所有检索结果，会保留非模板频道名称的结果，推荐手动维护时开启 | False | | open_m3u_result | 开启转换生成 m3u 文件类型结果链接，支持显示频道图标 | True | | open_multicast | 开启组播源功能，关闭后所有组播源工作模式都将关闭 | True | | open_multicast_foodie | 开启 Foodie 组播源工作模式 | True | | open_multicast_fofa | 开启 FOFA 组播源工作模式 | True | | open_online_search | 开启关键字搜索源功能 | False | | open_proxy | 开启代理，自动获取免费可用代理，若更新无数据可开启此模式 | False | | open_request | 开启查询请求，数据来源于网络（仅针对酒店源与组播源） | False | | open_service | 开启页面服务，用于控制是否启动结果页面服务；如果使用青龙等平台部署，有专门设定的定时任务，需要更新完成后停止运行，可以关闭该功能 | True | | open_sort | 开启排序功能（响应速度、日期、分辨率） | True | | open_subscribe | 开启订阅源功能 | False | | open_update | 开启更新，用于控制是否更新接口，若关闭则所有工作模式（获取接口和测速）均停止 | True | | open_update_time | 开启显示更新时间 | True | | open_url_info | 开启显示接口说明信息，用于控制是否显示分辨率、接口协议类型等信息，为$符号后的内容，播放软件使用该信息对接口进行描述 | True | | open_use_cache | 开启使用本地缓存数据，适用于查询请求失败场景（仅针对酒店源与组播源） | True | | open_use_old_result | 开启使用历史更新结果（包含模板与结果文件的接口），合并至本次更新中 | True | | app_port | 页面服务端口，用于控制页面服务的端口号 | 8000 | | final_file | 生成结果文件路径 | output/result.txt | | hotel_num | 结果中偏好的酒店源接口数量 | 10 | | hotel_page_num | 酒店地区获取分页数量 | 1 | | hotel_region_list | 酒店源地区列表，"全部"表示所有地区 | 全部 | | ipv4_num | 结果中偏好的 IPv4 接口数量 | 5 | | ipv6_num | 结果中偏好的 IPv6 接口数量 | 5 | | ipv6_support | 强制认为当前网络支持IPv6，跳过检测 | False | | ipv_type | 生成结果中接口的协议类型，可选值：ipv4、ipv6、全部、all | 全部 | | ipv_type_prefer | 接口协议类型偏好，优先将该类型的接口排在结果前面，可选值：IPv4、IPv6、自动、auto | 自动 | | min_resolution | 接口最小分辨率，需要开启 open_filter_resolution 才能生效 | 1920x1080 | | min_speed | 接口最小速率（单位M/s），需要开启 open_filter_speed 才能生效 | 0.2 | | multicast_num | 结果中偏好的组播源接口数量 | 10 | | multicast_page_num | 组播地区获取分页数量 | 1 | | multicast_region_list | 组播源地区列表，"全部"表示所有地区 | 全部 | | online_search_num | 结果中偏好的关键字搜索接口数量 | 0 | | online_search_page_num | 关键字搜索频道获取分页数量 | 1 | | origin_type_prefer | 结果偏好的接口来源，结果优先按该顺序进行排序，逗号分隔，例如：hotel,multicast,subscribe,online_search；hotel：酒店源，multicast：组播源，subscribe：订阅源，online_search：关键字搜索；不填写则表示不指定来源，按照接口速率排序 | | | recent_days | 获取最近时间范围内更新的接口（单位天），适当减小可避免出现匹配问题 | 30 | | request_timeout | 查询请求超时时长，单位秒(s)，用于控制查询接口文本链接的超时时长以及重试时长，调整此值能优化更新时间 | 10 | | sort_timeout | 单个接口测速超时时长，单位秒(s)；数值越大测速所属时间越长，能提高获取接口数量，但质量会有所下降；数值越小测速所需时间越短，能获取低延时的接口，质量较好；调整此值能优化更新时间 | 10 | | source_file | 模板文件路径 | config/demo.txt | | subscribe_num | 结果中偏好的订阅源接口数量 | 10 | | urls_limit | 单个频道接口数量 | 10 | ## 快速上手 ### 工作流 Fork 本项目并开启工作流更新，具体步骤请见[详细教程](./docs/tutorial.md) ### 命令行 ```shell pip install pipenv ``` ```shell pipenv install --dev ``` 启动更新： ```shell pipenv run dev ``` 启动服务： ```shell pipenv run service ``` ### GUI 软件 1. 下载[IPTV-API 更新软件](https://github.com/Guovin/iptv-api/releases)，打开软件，点击更新，即可完成更新 2. 或者在项目目录下运行以下命令，即可打开 GUI 软件： ```shell pipenv run ui ``` <img src="./docs/images/ui.png" alt="IPTV-API更新软件" title="IPTV-API更新软件" style="height:600px" /> ### Docker - iptv-api（完整版本）：性能要求较高，更新速度较慢，稳定性、成功率高；修改配置 open_driver = False 可切换到 Lite 版本运行模式（推荐酒店源、组播源、关键字搜索使用此版本） - iptv-api:lite（精简版本）：轻量级，性能要求低，更新速度快，稳定性不确定（推荐订阅源使用此版本） 1. 拉取镜像： - iptv-api： ```bash docker pull guovern/iptv-api:latest ``` - iptv-api:lite： ```bash docker pull guovern/iptv-api:lite ``` 2. 运行容器： - iptv-api： ```bash docker run -d -p 8000:8000 guovern/iptv-api ``` - iptv-api:lite： ```bash docker run -d -p 8000:8000 guovern/iptv-api:lite ``` 卷挂载参数（可选）： 实现宿主机文件与容器文件同步，修改模板、配置、获取更新结果文件可直接在宿主机文件夹下操作 以宿主机路径/etc/docker 为例： - iptv-api： ```bash docker run -v /etc/docker/config:/iptv-api/config -v /etc/docker/output:/iptv-api/output -d -p 8000:8000 guovern/iptv-api ``` - iptv-api:lite： ```bash docker run -v /etc/docker/config:/iptv-api-lite/config -v /etc/docker/output:/iptv-api-lite/output -d -p 8000:8000 guovern/iptv-api:lite ``` 端口环境变量： ```bash -e APP_PORT=8000 ``` 3. 更新结果： - 接口地址：ip:8000 - M3u 接口：ip:8000/m3u - Txt 接口：ip:8000/txt - 接口内容：ip:8000/content - 测速日志：ip:8000/log ## 更新日志 [更新日志](./CHANGELOG.md) ## 赞赏 <div>开发维护不易，请我喝杯咖啡☕️吧~</div> | 支付宝 | 微信 | |--------------------------------------|-----------------------------------------| |  |  | ## 关注 微信公众号搜索 Govin，或扫码，接收更新推送、学习更多使用技巧：  ## 免责声明 本项目仅供学习交流用途，接口数据均来源于网络，如有侵权，请联系删除 ## 许可证 [MIT](./LICENSE) License &copy; 2024-PRESENT [Govin](https://github.com/guovin) ", Assign "at most 3 tags" to the expected json: {"id":"11994","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"