webhtv

项目概述

WebHomeTV 是基于 FongMi/TV 与 CatVod 生态二次开发的 Android 影音应用，保留点播、直播、Spider、解析、投屏和本地 HTTP 服务等能力，并重点增强 WebHome 自定义首页、App Native SDK、管理页面、远程托管、WebHome 扩展、登录态学习同步、网盘链接检测、站点健康排序、观影记录同步以及 Nostr 与 TMDB 推荐首页。

主要功能

• 点播、直播、Spider 爬虫、解析播放、投屏与本地 HTTP 服务
• 网盘分享链接有效性检测，WebHome 与本地 HTTP API 均可调用
• 站点健康排序，自动学习站点搜索、详情与播放成功率
• 局域网管理页面，可管理文件、登录态、同步目录、站点注入与接口
• 远程托管，通过自建 Cloudflare、Deno、Vercel、Go 或 Rust 中转服务绑定多台设备
• 一键同步配置、站源数据、登录态、观看历史与应用设置
• 站点注入与 WebHome 扩展，用 HTML、CSS、JavaScript 定制首页并注入用户脚本
• 观影记录同步、Webhook 上报与爬虫 HTTP API

适用人群

• 想在电视或手机上自建影音聚合播放体验的用户
• 希望用网页技术定制播放器首页的开发者
• 需要远程管理多台设备与同步数据的进阶用户

快速上手

1. 克隆仓库并进入目录
2. 创建 local.properties 并写入 sdk.dir 指向 Android SDK 路径
3. 执行 bash gradlew :app:assembleMobileArm64_v8aDebug 打包手机端
4. 执行 bash gradlew :app:assembleLeanbackArm64_v8aDebug 打包电视端
5. 安装 APK 后在设置页的增强功能中配置站点与首页

核心优势

• 保留成熟 CatVod 生态与 Spider 体系，兼容现有配置
• 把 CSP 站点首页升级为可编程的网页应用，Native 能力通过 SDK 暴露
• 覆盖网盘检测、健康排序、远程托管、观影记录同步等实用增强
• 提供从管理页到调试日志的完整排障入口

系统要求

• 操作系统：Android（手机端与电视端）
• 支持架构：arm64-v8a、armeabi-v7a
• 构建环境：JDK 21、Python 3.10、Android SDK Platform 37、Build Tools 37.0.0

注意事项

• 构建依赖 JDK 21 与 Python 3.10，版本不符会失败
• 普通 Android 依赖仍需联网下载，必要时配置代理
• 软件仅供技术学习与交流，请遵守所在地区法律法规与版权要求