sec-an / TVHelper

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

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

影视助手

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

  • 可以使用一键脚本更新
  • v1.0.0项目结构不够规范,v1.1.1进行了规范化
  • 如果已经安装了v1.0.0版本,请将项目根目录下的configlivesource_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_TVHelperTVHelper所在的路径

[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并添加如下内容,其中PROGTVHelper所在的路径

#!/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

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

License:GNU General Public License v3.0


Languages

Language:Go 90.2%Language:Shell 9.8%