IPTV播放列表可用性检查工具iptv-checker

什么是 iptv-checker ?

iptv-checker 是一个用于检查 IPTV 播放列表可用性的工具,支持 Docker、桌面应用和命令行模式。通过使用 iptv-checker,用户能够有效管理和验证其 IPTV 播放列表,确保获取高质量的观看体验。

主要特点

  1. 多平台支持:可以在 DockerWindowsmacOSLinux 上运行,提供灵活的使用方式。
  2. 功能:主要用于检查 IPTV 播放列表的可用性,确保用户获取的频道链接正常工作。
  3. 易于部署:用户可以通过 Docker Hub 安装和运行该工具,简单的命令可以快速启动服务。
  4. 背景任务:支持后台检查功能,用户可以设置任务并进行并行处理。
  5. 用户界面:提供友好的用户界面,允许用户管理和查看检查结果。
  6. 更新和维护:项目定期更新,修复已知问题并增加新功能。
  7. 开源项目:该工具是开源的,允许用户查看和修改源代码。

iptv-checker 支持 m3u 链接、m3u 源文件,可以帮助你检查这些源是否有效,并将这些有效的另存为新的 m3u文件

从功能上来说,和老苏之前介绍的 iptv-m3u-maker 类似

文章传送门:直播源自动检测工具iptv-m3u-maker

不过 iptv-checker 可不仅仅只是测试网络及延时,而是采用了 ffmpeg 中的 ffprobe 来分析多媒体文件的格式和流信息,所以准确率相当高

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 iptvchecker ,选择第一个 zmisgod/iptvchecker,双击直接下载。

老苏最早使用时, 只有一个 latest 版本,软件版本对应为 2.15.1

现在最新的版本,latest 版本对应为 v4.0.1.1

docker 文件夹中,创建一个新文件夹 iptvchecker,并在其中建两个子文件夹 inputoutput

文件夹 装载路径 说明
docker/iptvchecker/input /app/static/input 待检查的文件
docker/iptvchecker/output /app/static/output 检查之后的输出文件

端口

本地端口不冲突就行,不确定的话可以用命令查一下

1
2
# 查看端口占用
netstat -tunlp | grep 端口号
本地端口 容器端口
8084 8089

老版本的容器端口是 8080

现在的默认的容器端口改为了 8089

当然你也可以用环境变量 WEB_PORT 修改默认值

命令行安装

如果你熟悉命令行,可能用 docker cli 更快捷

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 新建文件夹 iptvchecker
mkdir -p /volume1/docker/iptvchecker/{input,output}

# 进入 iptvchecker 目录
cd /volume1/docker/iptvchecker

# 运行容器
docker run -d \
--restart unless-stopped \
--name iptvchecker \
-p 8084:8089 \
-v $(pwd)/input:/app/static/input \
-v $(pwd)/output:/app/static/output \
zmisgod/iptvchecker

也可以用 docker-compose 安装,将下面的内容保存为 docker-compose.yml 文件

1
2
3
4
5
6
7
8
9
10
11
12
version: '3'

services:
iptvchecker:
image: zmisgod/iptvchecker
container_name: iptvchecker
restart: unless-stopped
ports:
- 8084:8089
volumes:
- ./input:/app/static/input
- ./output:/app/static/output

然后执行下面的命令

1
2
3
4
5
6
7
8
9
10
# 新建文件夹 iptvchecker
mkdir -p /volume1/docker/iptvchecker/{input,output}

# 进入 iptvchecker 目录
cd /volume1/docker/iptvchecker

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中输入 http://群晖IP:8084 就能看到主界面

2.15.1 的主界面

v4.0.1.1 的主界面,颜色的设置有点奇怪

如果界面显示为英文,可以进入 System Settings –> language 可以选择 中文

检测源

检测源 用于检测自己的源,输入框支持下面几种格式:

  • 支持标准格式的m3u链接,如有多个请用英文逗号做分割符,比如:http://startv.m3u,http://starmovies.m3u
  • 支持类似:star movies,http://srtarmovies.com/111.m3u8
  • 支持类似:http://srtarmovies.com/111.m3u8,http://srtarmovies.com/222.m3u8
  • 支持 m3u 文件原始内容,类似:#EXTM3U\n#EXTINF:-1\nhttp://srtarmovies.com/111.m3u8

如果安装了 allinone ,可以把订阅地址 http://192.168.0.199:35455/tv.m3u 放进去试试

开始检查

500ms 以内是绿色的,500ms 以上是红色的,哭脸是不可用的;

检测完成后,可以选择有效链接导出

可以选择导出的格式

当然你还可以 再次处理,进行二次筛选

生成的结果下载后,可以导入到播放器

公共订阅源

菜单中选择 公共订阅源,这里的源来自 github 上的 iptv-org。这个源大概有 3 万多个频道,在介绍播放器 streamdock 一文中提到过,但当时是直接使用的,所以成功率不高

文章传送门:Web版IPTV播放器streamdock

下拉框中选择需要测试的源,例如 China

17 个源中只有一个是可用的,所以测试还有很有用的,毕竟有效性比数量更重要

定时任务

菜单中选择 定时任务 –> 添加在线链接

保存之后会生成任务 id

当任务执行完成后,日志中会看到类似的解析

FileStation 中会看到输出文件

不想等待,可以点 刷新列表 –> 立即执行

桌面客户端

如果你没有 Docker 环境,也可以直接下载客户端,支持 WindowsMacOS

下载地址:https://github.com/zhimin-dev/iptv-checker/releases

Windows 为例,需要安装

界面和功能是一样的,所以只介绍一下多出来的 Watch Online

切换成中文后就是 在线观看

如果格式不支持,会提示 the format is not supported.

感觉能播放的很少

如果是在 Windows 上观看,还是建议用 Potplayer 这种原生的播放器吧

参考文档

zhimin-dev/iptv-checker: IPTV source checker tool for Docker to check if your playlist is available
地址:https://github.com/zhimin-dev/iptv-checker

zmisgod/iptvchecker - Docker Image | Docker Hub
地址:https://hub.docker.com/r/zmisgod/iptvchecker

iptv-org/iptv: Collection of publicly available IPTV channels from all over the world
地址:https://github.com/iptv-org/iptv