Skip to content
/ TVHelper Public

影视助手，配置订阅整合、解析、代理，豆瓣主页

License

GPL-3.0 license
86 stars 54 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

sec-an/TVHelper

BranchesTags

Repository files navigation

影视助手

v1.0.0 -> v1.1.1 升级说明

  • 可以使用一键脚本更新
  • v1.0.0项目结构不够规范，v1.1.1进行了规范化
  • 如果已经安装了v1.0.0版本，请将项目根目录下的config、live、source_config目录移至configs目录下
  • configs/config.yaml可修改TVHelper启动端口、启用Redis进行缓存等
  • 项目运行日志默认会存储在logs目录下，请确保TVHelper对该目录具有写权限

痛点

  • 使用在线配置，不方便对配置进行个性化修改
  • 在线配置缓存至本地，担心更新不及时

功能（详见configs/config/sample.json）

  • 极高的自定义程度
  • 多源整合、处理（在线缝合）
    • http://你的IP:16214/config/sample
    • 去重
    • 🌟失效自动切换备用源
    • 多Jar
    • 同时支持本地、在线订阅
      • http://你的IP:16214/config/src/demo/config.json
      • http://你的IP:16214/config/src/demo/custom_spider.jar;md5;a84fef826cb82da525469e8acf1e7d9a
  • 点播源黑名单:u7981:，指定名称的点播源不再展示
  • 直播源替换，本地文件服务器
    • http://你的IP:16214/live/IPTV.m3u
  • 豆瓣主页
    • http://你的IP:16214/home?douban=你的豆瓣id
  • ...

一键脚本

安装

curl -fsSL "https://gh-proxy.com/https://raw.githubusercontent.com/sec-an/TVHelper/main/v1.sh" | bash -s install

更新

curl -fsSL "https://gh-proxy.com/https://raw.githubusercontent.com/sec-an/TVHelper/main/v1.sh" | bash -s update

卸载

curl -fsSL "https://gh-proxy.com/https://raw.githubusercontent.com/sec-an/TVHelper/main/v1.sh" | bash -s uninstall

自定义路径

默认安装在/opt/TVHelper中，自定义安装路径，将安装路径作为第二个参数添加，必须是绝对路径（如果路径以TVHelper结尾，则直接安装到给定路径，否则会安装在给定路径TVHelper目录下），如安装到/root：

# Install
curl -fsSL "https://gh-proxy.com/https://raw.githubusercontent.com/sec-an/TVHelper/main/v1.sh" | bash -s install /root
# update
curl -fsSL "https://gh-proxy.com/https://raw.githubusercontent.com/sec-an/TVHelper/main/v1.sh" | bash -s update /root
# Uninstall
curl -fsSL "https://gh-proxy.com/https://raw.githubusercontent.com/sec-an/TVHelper/main/v1.sh" | bash -s uninstall /root
  • 启动：systemctl start TVHelper
  • 关闭：systemctl stop TVHelper
  • 状态：systemctl status TVHelper
  • 重启：systemctl restart TVHelper

手动安装

获取TVHelper

打开TVHelper Release下载待部署系统对应的文件。

运行

# 解压下载的文件，得到可执行文件：
tar -zxvf TVHelper_*.tar.gz
# 授予程序执行权限：
chmod +x TVHelper
# 运行程序
./TVHelper

守护进程（Linux systemd）

使用任意方式编辑/usr/lib/systemd/system/TVHelper.service并添加如下内容，其中path_TVHelper为TVHelper所在的路径

[Unit]
Description=TVHelper service
Wants=network.target
After=network.target network.service
 
[Service]
Type=simple
WorkingDirectory=path_TVHelper
ExecStart=path_TVHelper/TVHelper
KillMode=process
Restart=always
 
[Install]
WantedBy=multi-user.target

然后，执行systemctl daemon-reload重载配置，现在你可以使用这些命令来管理程序：

  • 启动：systemctl start TVHelper
  • 关闭：systemctl stop TVHelper
  • 配置开机自启：systemctl enable TVHelper
  • 取消开机自启：systemctl disable TVHelper
  • 状态：systemctl status TVHelper
  • 重启：systemctl restart TVHelper

守护进程（OpenWrt等 procd）

使用任意方式编辑/etc/init.d/TVHelper并添加如下内容，其中PROG为TVHelper所在的路径

#!/bin/sh /etc/rc.common

START=99
STOP=98

USE_PROCD=1

DAEMON=TVHelper
PROG=/opt/TVHelper

start_service() {
    procd_open_instance TVHelper
    procd_set_param command $PROG/$DAEMON -d $PROG
    procd_set_param respawn
    procd_close_instance
    echo "service TVHelper start"
}

stop_service() {
    killall $DAEMON
    echo "service TVHelper stop"
}

然后，你可以使用这些命令来管理程序：

  • 启动：/etc/init.d/TVHelper start
  • 关闭：/etc/init.d/TVHelper stop
  • 配置开机自启：/etc/init.d/TVHelper enable
  • 取消开机自启：/etc/init.d/TVHelper disable
  • 状态：/etc/init.d/TVHelper status

如何更新

在TVHelper Release下载新版TVHelper，替换之前的版本即可。

配置示例

无注释模板

配置样例

// 请自行新建配置，本配置仅供参考，请勿修改，后期更新可能会覆盖！
// 请自行新建配置，本配置仅供参考，请勿修改，后期更新可能会覆盖！
// 请自行新建配置，本配置仅供参考，请勿修改，后期更新可能会覆盖！

// 最终配置地址为：http://你的ip:16214/config/文件名
// 本配置的地址为：http://你的ip:16214/config/sample

// 当前程序提供的豆瓣主页在：http://你的ip:16214/home?douban=你的豆瓣id
// 当前程序提供的直播文件服务器为：http://你的ip:16214/live/文件名.后缀
// 直播文件示例：http://你的ip:16214/live/IPTV.m3u
// 若订阅地址为本地文件，请在source_config目录下新建目录并放置在新建目录中
// 本地订阅：http://你的ip:16214/config/src/新建的文件夹名/文件名.后缀
// 本地订阅json示例：http://你的ip:16214/config/src/demo/config.json
// 本地订阅jar示例：http://你的ip:16214/config/src/demo/custom_spider.jar;md5;a84fef826cb82da525469e8acf1e7d9a"

{
  // 订阅地址列表
  "subscribe": [
    {
      // 订阅地址
      "url": "https://hutool.ml/tang",
      // multi-jar为false时，将采用第一个订阅地址中的spider或者本配置文件中新的spider
      "multi-jar": false,
      "always-on": false,
      // 点播源名称前缀自定义
      // 示例为在该订阅所有点播源的名称前添加"长老_"
      // 如果不需要，则改为："sites-prefix": ""
      "sites-prefix": "长老_",
      // 点播白名单，仅当Key(key)在该列表中的点播源将被添加到最终配置
      // 示例在下一订阅
      // 如果不需要，则改为："sites-whitelist": []
      "sites-whitelist": [],
      // 点播黑名单，Key(key)在该列表中的点播源将被移除，仅当未配置白名单时生效
      // 示例为移除Key为"Bili"点播源
      // 如果不需要，则改为："sites-blacklist": []
      "sites-blacklist": ["Bili"]
    },
    {
      "url": "http://饭太硬.ga/x/o.json",
      // multi-jar为true时
      // 本订阅中所有原本未定义多jar的站点
      // 将同一设置多jar为本订阅的spider
      "multi-jar": true,
      // 若always-on为false，且该订阅地址之前存在有效订阅，则不展示该订阅
      "always-on": false,
      // 点播源名称前缀自定义
      // 示例为在该订阅所有点播源的名称前添加"饭太硬$"
      // 如果不需要，则改为："sites-prefix": ""
      "sites-prefix": "饭太硬$",
      // 点播白名单，仅当Key(key)在该列表中的点播源将被添加到最终配置
      // 示例为仅选取饭太硬订阅中key为"csp_Alist1"和"csp_Alist2"的点播源
      // 如果不需要，则改为："sites-whitelist": []
      "sites-whitelist": ["csp_Alist1", "csp_Alist2"],
      // 点播黑名单，Key(key)在该列表中的点播源将被移除，仅当未配置白名单时生效
      // 示例为移除Key为"js豆瓣"点播源，由于当前订阅配置了白名单，该黑名单不会生效
      // 如果不需要，则改为："sites-blacklist": []
      "sites-blacklist": ["js豆瓣"]
    },
    {
      // 本地配置文件放置在source_config目录中，且需要在该目录下新建子文件夹
      // 配置地址为：http://你的ip:16214/config/src/新建的文件夹名/文件名.后缀
      "url": "http://127.0.0.1:16214/config/src/demo/config.json",
      // multi-jar为true时
      // 本订阅中所有原本未定义多jar的站点
      // 将同一设置多jar为本订阅的spider
      "multi-jar": true,
      // 该字段会替换该订阅中的spider
      // 本配置地址为：http://你的ip:16214/config/src/新建的文件夹名/文件名.后缀
      "jar": "http://127.0.0.1:16214/config/src/demo/custom_spider.jar;md5;a84fef826cb82da525469e8acf1e7d9a",
      // 若always-on为true，无论是否已存在有效订阅，都将展示该订阅
      "always-on": true,
      "sites-prefix": "",
      "sites-whitelist": [],
      "sites-blacklist": []
    }
  ],

  // 直播源，替换订阅配置，非增加，仅支持一组
  // 如果不需要替换，则改为："lives": []
  "lives": [
    {
      "name": "直播",
      // txt为0，json为1(仅影视支持json)
      "type": 1,
      // 可以在live文件夹中添加本地直播文件
      // 格式为：http://你的ip:16214/live/文件名.后缀
      // 示例：http://你的ip:16214/live/IPTV.m3u
      "url": "https://gh-proxy.com/https://raw.githubusercontent.com/FongMi/CatVodSpider/main/json/live.json",
      "epg": "http://epg.51zmt.top:8000/api/diyp/?ch={epg}&date={date}",
      "logo": "http://epg.51zmt.top:8000/{logo}",
      // 是否自动开启(仅影视支持)
      "boot": true,
      // 播放器，1：IJK，2：EXO
      "playerType": 1
    }
  ],

  // 点播源，数组合并至订阅配置sites数组 前
  // 如果不需要增加，则改为："sites-prepend": []
  "sites-prepend": [
    {
      "key": "T4-douban",
      "name": "豆瓣主页",
      "type": 4,
      // 本程序默认运行在当前设备16214端口且自带豆瓣主页服务
      // 该api可替换成http(s)://你的ip或域名(:16214)/home?douban=你的豆瓣id
      "api": "https://t4.secan.icu/vod?douban=你的豆瓣id",
      "searchable": 0,
      "filterable": 1
    }
  ],

  // 点播源，数组合并至订阅配置sites数组 后
  // 如果不需要增加，则改为："sites-append": []
  "sites-append": [
    {
      "key": "Live",
      "name": "直播",
      "type": 3,
      "api": "csp_Live",
      "searchable": 0,
      "filterable": 0,
      // 设定延迟多少毫秒后进入直播
      "ext": "2000",
      // 首屏直播需要使用FongMi的底包，可能需要使用多jar
      "jar": "https://gh-proxy.com/https://raw.githubusercontent.com/FongMi/CatVodSpider/main/jar/custom_spider.jar"
    },
    {
      "key": "易搜",
      "name": "易搜",
      "type": 3,
      "api": "csp_YiSo",
      "searchable": 1,
      "filterable": 0,
      // 换源，0：关闭，1：开启
      "changeable": 1,
      // 播放器，1：IJK，2：EXO
      "playerType": 2,
      "ext": "http://我不是.肥猫.love:63/token.php"
    }
  ],

  // 自定义爬虫，非空则替换订阅中的爬虫
  // 如果不需要替换，则改为："spider": ""
  "spider": "",

  // 壁纸，非空则替换订阅中的壁纸
  // 如果不需要替换，则改为："wallpaper": ""
  "wallpaper": "",

  // VIP解析标识，对象合并至订阅配置flags数组后
  // 如果不需要替换，则改为："mix-flags": []
  "mix-flags": [],

  // 解析地址，对象合并至订阅配置parses数组后
  // 如果不需要替换，则改为："mix-parses": []
  "mix-parses": [],

  // 解析广告过滤，对象合并至订阅配置ads数组后
  // 如果不需要替换，则改为："mix-ads": []
  "mix-ads": []
}

优先适配:thumbsup:

📺 FongMi / TV

About

影视助手，配置订阅整合、解析、代理，豆瓣主页

Resources

Readme

License

GPL-3.0 license
Activity

Stars

86 stars

Watchers

5 watching

Forks

54 forks
Report repository

Releases 5

v1.2.5 Latest
Feb 7, 2024
+ 4 releases

Languages