rhdpin/nhltv-fetcher

nhltv-fetcher

nhltv-fetcher是为NHL.TV订阅者设计的工具，旨在解决官方播放器（网页、移动、电视端）回看比赛时易剧透的问题（如时间线暴露加时信息），支持下载比赛为MP4文件离线观看，或通过VLC直接播放，也可将比赛feed作为HTTP流发布供其他设备访问。

核心功能

• 基于.NET 6.0/C#开发，跨平台支持Windows、MacOS和Linux
• 命令行界面操作
• 支持选择特定比赛或获取球队最新比赛
• 将比赛下载为MP4文件
• 通过VLC直接播放比赛流（无需保存文件）
• 将比赛feed发布为HTTP流，供无法直接访问的设备使用

使用场景

1. NHL.TV订阅者希望离线观看比赛
2. 避免官方播放器的剧透问题（如时间线暴露比赛时长或加时信息）
3. 使用自定义媒体播放器（如Kodi）观看比赛
4. 将比赛流分享给不支持直接访问NHL.TV的设备

配置说明

前提条件

• 拥有有效的NHL.TV订阅账号
• 受NHL.TV的地理限制（与官方服务一致）

安装与部署

1. 创建认证文件
   在合适的目录（如/home/user/.nhltv-fetcher）下创建auth.json，内容包含NHL.TV账号信息：

json
{ "email": "你的NHL.TV账号邮箱", "password": "你的NHL.TV账号密码" }

2. Docker运行示例

bash
docker run -it --rm -v /mnt/download:/app/download -v /home/user/.nhltv-fetcher:/app/config --network=host rhdpin/nhltv-fetcher:linux-x64 -c -p /app/download -a /app/config/auth.json

• -v /mnt/download:/app/download：将主机下载目录映射到容器内
• -v /home/user/.nhltv-fetcher:/app/config：将主机配置目录映射到容器内以读取认证文件

常用命令示例

选择比赛并下载

bash
docker run -it --rm -v /mnt/download:/app/download -v /home/user/.nhltv-fetcher:/app/config --network=host rhdpin/nhltv-fetcher:linux-x64 -c -p /mnt/download

执行后会列出可用比赛feed，选择对应编号即可下载到/mnt/download目录。

获取球队最新比赛

bash
docker run -it --rm -v /mnt/download:/app/download -v /home/user/.nhltv-fetcher:/app/config --network=host rhdpin/nhltv-fetcher:linux-x64 -t NYR -p /mnt/download

替换NYR为目标球队的三字母缩写（如WPG），工具会自动获取该球队最新比赛并下载。

直接用VLC播放

bash
docker run -it --rm -v /home/user/.nhltv-fetcher:/app/config --network=host rhdpin/nhltv-fetcher:linux-x64 -t NYR -l

需确保主机已安装VLC且可在PATH环境变量中找到。

参数说明

  -a, --auth-file-path    (默认: 当前目录的auth.json) 设置认证文件的完整路径  
  -b, --bitrate           (默认: best) 指定下载流的比特率，使用 verbose 模式查看可用选项  
  -c, --choose            从找到的feed列表中选择  
  -d, --days              (默认: 2) 指定回溯搜索比赛的天数  
  -e, --date              (默认: 当前日期) 指定搜索比赛的日期（格式：yyyy-MM-dd，如2019-12-22）  
  -h, --hide-progress     隐藏下载进度信息  
  -l, --play              直接播放feed而非保存到文件（需VLC已安装且在PATH中）  
  -o, --overwrite         覆盖已存在的文件（而非跳过下载）  
  -p, --path              (默认: 当前目录) 设置下载目标路径  
  -s, --stream            将feed发布为网络流，通过输出的URL访问  
  -t, --team              获取指定球队的最新比赛（三字母缩写，如WPG）  
  -u, --url               仅获取流的URL（用于Streamlink）而非下载  
  -v, --verbose           启用详细输出模式  
  --help                  显示帮助信息  
  --version               显示版本信息