WebHomeTV

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

项目的核心目标不是替换 CSP/Spider 体系,而是让 CSP 站点首页变成一个真正可开发的网页应用:开发者用 HTML/CSS/JavaScript 定制首页,再通过 App 暴露的 Native 能力完成搜索、播放、跨域请求、资源代理、最近观看、网盘检测和状态同步。

增强功能

网盘检测:内置网盘分享链接有效性检测,WebHome 和本地 HTTP API 均可调用。
站点健康排序:自动学习站点搜索、详情和播放成功率,搜索与换源优先使用更可用的站点;站点弹窗默认保留用户配置顺序,可在弹窗内单独开启健康排序。
管理页面:在 App 内启动局域网浏览器管理页 /m,可管理本机或远端设备文件、登录态、同步目录、站点注入、接口、壳代理、搜索和推送,运行期间通过前台服务保活。
远程托管:通过自建 Cloudflare/Deno/Vercel/Go/Rust 中转服务绑定多台 WebHTV 设备,支持设备状态、远程搜索/推送、接口配置、主页设置、一键同步和最近日志;Go/Rust 版支持 WebSocket 实时通道,不支持时自动回退 HTTP 轮询。部署说明和二进制见远程托管中转服务器文档及二进制。
一键同步:在同一局域网设备间同步配置、站源数据(Jar/脚本保存数据)、登录态、WebHome 数据、搜索记录、观看历史、收藏和应用设置,每项可单独勾选。
站点注入:添加自定义 WebHome 或通用 CSP 站点,主列表显示核心摘要和快捷操作,新增/修改在独立表单中维护启用状态、插入位置、首页、搜索和换源行为;顶部“识别”可粘贴单个或多个松散站点 JSON 片段并自动归类追加;WebHome 站点级扩展可直接填写扩展 URL / JSON,也可选择本地 JS/CSS/JSON 自动生成配置。
WebHome 扩展:给真实网页注入用户脚本,主列表显示扩展摘要和状态,新增/修改在独立表单中配置本地文件、远程链接/manifest、直接代码、表单生成或 JSON;匹配范围默认从当前点播配置的 WebHome 站点弹窗多选,也可切换到 CSP key 正则;提供调试工作台用于 Web 预览、Console/Network/Elements 和代码保存预览。
观影记录同步:增强功能中提供独立总览页,包含总开关、本机 API 修改开关、远端同步源和 Webhook 上报。爬虫可通过 /api/playback/current 读取当前播放记录,也可在用户开启修改后调用 /api/playback/progress、/api/playback/progress/batch 或 /api/playback/progress/delete 写入/清理本地进度;App 也可从用户配置的远端 API 拉取批量记录合并到本地历史,并通过删除墓碑同步清理记录。仓库内置的 Cloudflare、Deno、Vercel、Go、Rust 五种服务端都可用同一 URL 同时承接 Webhook 和增量拉取，分别使用 Durable Object SQLite、Deno KV、Redis REST 或本地原子文件持久化。完整协议见 webhome-devkit/docs/应用完整开发文档.md 的“观影记录同步”章节。
登录态学习:用户手动开启后学习 Cookie、Token、接口 Jar 网盘登录文件等登录态路径,待确认项可在管理页查看/编辑,并可参与一键同步。
APP 代理:配置代理地址和域名匹配规则,可按当前站点自动建议代理域名,用于改善特定站点、接口或播放链路的网络访问。
调试日志:本机和局域网日志查看入口,便于排查播放、代理、站源和 WebHome 相关问题。

以上能力集中在设置页的"增强功能"入口,手机端和电视端均为独立设置页。

效果演示

home.mp4

演示视频对应的站点配置(Nostr/TMDB 推荐首页):

{
  "key": "Nostr",
  "name": "Nostr推荐",
  "type": 3,
  "api": "csp_Nostr",
  "homePage": "https://www.252035.xyz/xs/tvbox/nostr.html"
}

文档

完整开发说明见 应用完整开发文档.md,包含:

App 配置字段(点播、解析、直播、样式)
Spider 开发,JS/Python Spider 运行时
本地 HTTP 服务端点总览
WebHome SDK 全部方法的参数和返回值
透明背景、电视端遥控器 UX、性能最佳实践
网盘检测 API 和站点健康排序
观影记录同步、Webhook 上报和爬虫 HTTP API
管理页面和局域网 HTTP 能力
远程托管部署、绑定流程和能力边界
WebHome 扩展脚本开发
登录态学习与同步
PanSou 集成、Nostr 首页实现要点
隐藏功能和使用技巧
Android Intent、DLNA、MediaSession
CORS、Cookie 和网络策略

WebHome 主页、扩展、模板、示例和 AI skills 统一放在 webhome-devkit/ （附独立 CNB 仓库）：

扩展脚本开发指南见 webhome-devkit/README.md。
扩展示例见 webhome-devkit/examples/extensions/。
主页示例见 webhome-devkit/examples/homepages/。
模板见 webhome-devkit/templates/。
AI 编程客户端如何接入和复用 Skills,见 webhome-devkit/skills/。

配置文件和示例 HTML 放在同一服务器目录时,homePage 可直接写相对路径。

社区内容:

网友自制分享

构建

本节按“新机器 clone 后直接复制命令打包”为目标维护。当前分支使用较新的 Android/Gradle/Media3/MPV native 组合，环境不满足时最常见的失败点是 JDK、Android SDK 37、NDK 和依赖下载网络。

环境要求

JDK 21。不要使用 JDK 17；当前 sourceCompatibility / targetCompatibility 均为 Java 21。
Python 3.10。Chaquo 运行时和构建时 Python 均固定为 3.10，仅安装 Python 3.11/3.12/3.13 会失败。
Android SDK Platform 37 和 Build Tools 37.0.0。当前 compileSdk=37、minSdk=24、targetSdk=28。
Android NDK 29.0.14206865（r29）用于重建 MPV/FFmpeg/libplacebo 和 MPV JNI；NDK 28.2.13676358（r28c）继续用于 IJK/DVD。普通 Gradle 打包直接使用仓库已提交二进制，不要求安装 NDK。scripts/build_mpv_player_jni.sh 只重建 JNI 桥接库 libplayer.so，不会重编 libmpv.so、FFmpeg 或 libplacebo。
使用仓库内置 Gradle Wrapper：Gradle 9.5.1，Android Gradle Plugin 9.2.1。
能访问 Maven Central、Google Maven、Gradle Plugin Portal 和 JitPack。仓库内已带定制 Media3、nextlib 和本地 AAR，但普通 Android 依赖仍需要联网下载。

macOS/Linux 可用以下命令确认版本：

java -version
bash gradlew --version

如果依赖下载需要代理，先在当前终端设置：

export https_proxy=http://127.0.0.1:7897
export http_proxy=http://127.0.0.1:7897
export all_proxy=socks5://127.0.0.1:7897

从零 clone 到打包

先安装或确认 Android SDK。Android Studio 打开项目时通常会自动生成 local.properties；命令行构建需要进入仓库根目录后手动创建。macOS 默认 SDK 路径示例：

export ANDROID_HOME="$HOME/Library/Android/sdk"

Linux 常见路径是 $HOME/Android/Sdk，Windows 使用 Android Studio 打开项目或创建 local.properties，内容类似 sdk.dir=C\:\\Users\\你的用户名\\AppData\\Local\\Android\\Sdk。

如 SDK 未安装 API 37、Build Tools 或 Platform Tools，可用 Android Studio SDK Manager 安装，或使用命令行工具：

"$ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager" \
  "platform-tools" \
  "platforms;android-37.0" \
  "build-tools;37.0.0"
yes | "$ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager" --licenses

clone 仓库后直接打 debug 包：

git clone https://github.com/fish2018/webhtv.git
cd webhtv
printf 'sdk.dir=%s\n' "$ANDROID_HOME" > local.properties
bash gradlew :app:assembleMobileArm64_v8aDebug :app:assembleLeanbackArmeabi_v7aDebug :app:assembleLeanbackArm64_v8aDebug

如果构建指定开发分支，在 clone 后切换到对应分支再打包：

git fetch origin
git switch beta
bash gradlew clean
bash gradlew :app:assembleMobileArm64_v8aDebug

已 clone 仓库更新当前分支：

git fetch origin
git pull --ff-only
bash gradlew clean

常用本地打包命令

debug 包适合本地安装测试，构建速度更快：

bash gradlew :app:assembleMobileArm64_v8aDebug
bash gradlew :app:assembleMobileArmeabi_v7aDebug
bash gradlew :app:assembleLeanbackArm64_v8aDebug
bash gradlew :app:assembleLeanbackArmeabi_v7aDebug

release 包适合分发测试或正式发布：

bash gradlew :app:assembleMobileArm64_v8aRelease
bash gradlew :app:assembleMobileArmeabi_v7aRelease
bash gradlew :app:assembleLeanbackArm64_v8aRelease
bash gradlew :app:assembleLeanbackArmeabi_v7aRelease

临时验证“仅 Release 包可用”的接口时，可以关闭 R8/资源压缩，获得接近 debug 的构建速度：

bash gradlew :app:assembleMobileArm64_v8aRelease -PfastRelease=true

快速 Release 的版本标识为 <versionName>-fast-yyyyMMddHHmm（当前例如 5.6.0-fast-202608101200），时间使用上海时区；不传 -PfastRelease=true 时仍执行正常 Release 优化，版本标识保持 <versionName>-yyyyMMddHHmm。快速包只用于临时测试，不代替正式发布包。

也可以一次打常用三包：手机 64 位、电视 32 位、电视 64 位。

bash gradlew :app:assembleMobileArm64_v8aDebug :app:assembleLeanbackArmeabi_v7aDebug :app:assembleLeanbackArm64_v8aDebug

MPV native/JNI 重建

普通打包不需要执行本节命令，Gradle 会把仓库内已提交的 MPV assets 和 libplayer.so 打进 APK。修改以下内容时需要重建 MPV JNI：

third_party/mpv-player-jni/src/**
third_party/mpv-player-jni/include/mpv/client.h
third_party/mpv-player-jni/include/mpv/stream_cb.h
升级 MPV client API，或新的 libmpv.so 与现有 JNI 头文件/API 不兼容

当前 libmpv.so 同时启用 OpenGL、Vulkan、libcurl 和 HTTP/2；libplayer.so 由本仓库 third_party/mpv-player-jni 构建，用于保留 END_FILE reason/error 等本地桥接能力。当前 native 基线：

ABI	MPV	FFmpeg	libplacebo	网络后端	说明
`arm64-v8a`	`0.41.0-940-gcca559b41`	`04482c8d13ac`（9.0-fongmi）	`7.375.0` / `b694a21bf2dc`	curl 8.21.0 + nghttp2 1.69.0	2026-08-12 已按新 lock 与单一低负载 AImageReader 路径重编，完成能力、ELF、APK 资产和 arm64 真机启动校验
`armeabi-v7a`	`0.41.0-940-gcca559b41`	`04482c8d13ac`（9.0-fongmi）	`7.375.0` / `b694a21bf2dc`	curl 8.21.0 + nghttp2 1.69.0	2026-08-12 已按同一 lock 与相同路径独立重编，完成能力、ELF 与 32 位电视 Debug 打包校验

替换或升级 MPV native 时必须遵守：

libmpv.so、FFmpeg（codec/device/filter/format/util/swresample/swscale）、静态链接进 MPV 的 libplacebo、curl、nghttp2、MbedTLS 和 libc++_shared.so 必须按同一 ABI、同一 lock 成套构建，不能再混用旧 libmpv.so 与新依赖作为正式方案。
当前 native lock 使用 MPV cca559b41ceb0bb7731cf6ef2e1f33276cd30c42、FFmpeg 9.0-fongmi 04482c8d13ac27b2a9fe93f5d388929eef8af5f4、libplacebo b694a21bf2dc176c1e98b8a13c6421a0de5f3da5（7.375.0/API 375）、mpv-android 99a60ad2141d5ace94453590903c2c6b9a0a2443 和 NDK r29/API 24。curl 使用 MbedTLS 3.6.7，只启用 HTTP/HTTPS 与 HTTP/2，不包含 HTTP/3、ngtcp2、nghttp3 或 quiche。
最新 FongMi MPV 分支已经内建重写后的 AImageReader/AHardwareBuffer OpenGL/Vulkan 后端、异步 fence、HDR/Dolby Vision、双 Surface OSD 和 Android helper scheme；旧的 fd679c81 不是新分支祖先，原 mpv-aimagereader-transient-buffer.patch 已删除，不能在新分支上重复叠加。
Android Vulkan 硬解已固定为 v5.5.6-202608072014 验证过的单一 AHardwareBuffer YCbCr→RGB GPU 转换架构。构建时用 aimagereader-v556 源码/预生成 SPIR-V 覆盖上游互操作实现（保留当前接口、sync-fd 与计时适配），并应用 mpv-android-vulkan-single-backend.patch 删除 direct/stable/compute/fragment 选择和旧配置项；mpv-aimagereader-release-acquire-flow.patch 只稳定 MediaCodec 释放与 AImageReader 领取顺序，不代表另一种“stable”渲染后端。
mpv-aimagereader-gpu-timing.patch 把 AImageReader 独立转换提交的 GPU 时间计入 vo-passes，播放参数面板据此显示当前 MPV 渲染链的单一负载百分比。该数值用于同机同片源对比，不是系统全 GPU 占用率或整机功耗。
curl 与 nghttp2 静态链接进 libmpv.so，APK 不新增独立网络 .so。它增强 MPV 直接远程 HTTP/HTTPS 输入；App 自己处理的本地 HLS 代理、stream_cb 和 FFmpeg/lavf 路径仍按各自实现工作，不能把启用 curl 理解为所有播放请求都强制走同一后端。
FFmpeg 文件名、ELF SONAME 和所有 DT_NEEDED 都要从 libav*/libsw* 等长改为 libmv*/libmw*，不能只重命名文件，否则会和 nextlib-media3ext 内置 FFmpeg 发生 Android linker 复用冲突。
WebHTV 的完整 native 补丁/override 顺序以 third_party/mpv-native-build.md 和 scripts/build_mpv_native.sh 为准。修改 AImageReader override、MPV/FFmpeg 补丁、光盘控制补丁或 stream_cb.h 后必须重建对应 native；其中 stream_cb.h 变化还必须同时重建 libplayer.so。
更新后用 NDK llvm-readelf -d 确认没有残留 libav*.so/libsw*.so 依赖，再分别回归 OpenGL、Vulkan、硬解/软解、LUT、字幕、线路切换、连续起播/退出和 Blu-ray ISO。Android 15 必须同时检查 crash buffer 中是否出现 destroyed mutex。

从固定源码重新生成 MPV/FFmpeg .so：

scripts/build_mpv_native.sh --abi arm64-v8a --install
bash gradlew :app:assembleMobileArm64_v8aRelease -PfastRelease=true

需要更新仓库 assets 时，同步安装两套 ARM ABI；只有 JNI 源码、MPV client API 或 stream_cb.h 变化时才重建 JNI 桥：

scripts/build_mpv_native.sh --abi all --install
# 按需执行：scripts/build_mpv_player_jni.sh --abi all --install

脚本读取 third_party/mpv-native-lock.json，自动下载固定 commit、构建 FFmpeg 9/字体/字幕/光盘/归档/网络/Vulkan 依赖，应用 WebHTV 的补丁和 aimagereader-v556 override，修改 ELF 依赖名、strip 并校验。当前 lock 与两套已提交 assets 一致；libass 的 fontconfig/libxml2 字体回退栈静态链接进 libmpv.so，不会向 APK 内置中文字体或增加独立 .so。普通 Gradle 和 GitHub Actions 不会现场编译 MPV；Android Release Action 只运行 scripts/verify_mpv_native_assets.sh --require-elf，检查 shader 源/预生成头契约、文件集合、ABI、版本字符串、单一低负载 AImageReader 路径、已删除后端字符串、HTTP/2、字体提供器、HDR/Dolby Vision、光盘/Range/Matroska 标记、SONAME 和 DT_NEEDED。

只校验当前仓库已经提交的 MPV native assets：

bash scripts/verify_mpv_native_assets.sh

发布或 native 提交前应要求完整 ELF 校验；Linux 可使用系统 readelf，macOS 可使用 NDK 中的 llvm-readelf：

bash scripts/verify_mpv_native_assets.sh --require-elf

只重建 App JNI 桥接库 libplayer.so：

export ANDROID_HOME="$HOME/Library/Android/sdk"
export ANDROID_NDK_HOME="$ANDROID_HOME/ndk/29.0.14206865"
scripts/build_mpv_player_jni.sh --abi all --install
bash gradlew :app:assembleMobileArm64_v8aDebug

脚本会替换：

app/src/arm64_v8a/assets/mpv-libs/arm64-v8a/libplayer.so
app/src/armeabi_v7a/assets/mpv-libs/armeabi-v7a/libplayer.so

IJK native/FFmpeg 重建

普通 App 构建同样不会现场编译 IJK。仓库已经提交两套 ABI 的 libijkffmpeg.so、libijksdl.so 和 libijkplayer.so，Gradle 与 GitHub Actions 直接复用：

app/src/main/jniLibs/arm64-v8a/
app/src/main/jniLibs/armeabi-v7a/

ijk-bilibili-grouped-seek-20260713-083211 的最终稳定方案保留 TVBoxOSC FFmpeg 4.0 ABI，并在 App 的本地 DASH/HLS 代理层兼容 Bilibili。开发者修改 IJK C/C++、FFmpeg demuxer/protocol、MediaCodec 桥接或 native seek 行为时，才需要重建 .so。源码和工具链固定在 third_party/ijk-native-lock.json。

安装 native 构建依赖：

export ANDROID_HOME="$HOME/Library/Android/sdk" # Linux 通常为 $HOME/Android/Sdk
"$ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager" \
  "ndk;28.2.13676358"

# macOS
xcode-select -p >/dev/null 2>&1 || xcode-select --install
brew install openjdk@21 git python@3.10 pkg-config

# Ubuntu 24.04+
sudo apt-get update
sudo apt-get install -y openjdk-21-jdk git python3.10 python3.10-venv build-essential perl pkg-config file

重建并安装 arm64 IJK，然后打快速 Release：

export ANDROID_HOME="$HOME/Library/Android/sdk"
export ANDROID_NDK_HOME="$ANDROID_HOME/ndk/28.2.13676358"
bash scripts/build_ijk_native.sh --abi arm64-v8a --install
bash gradlew :app:assembleMobileArm64_v8aRelease -PfastRelease=true

Ubuntu 下重建 32 位 IJK：

export ANDROID_HOME="$HOME/Android/Sdk"
export ANDROID_NDK_HOME="$ANDROID_HOME/ndk/28.2.13676358"
bash scripts/build_ijk_native.sh --abi armeabi-v7a --install
bash gradlew :app:assembleLeanbackArmeabi_v7aRelease -PfastRelease=true

脚本会拉取锁定 commit 的 IJK/FFmpeg 4.0 与 OpenSSL openssl-3.2 源码、应用补丁、检查三项输出并按 --install 写入对应 ABI 目录。arm64 与 armeabi-v7a 均已在 macOS 使用 NDK 28.2.13676358 重建成功，并与 DVD 继续使用 r28c；MPV/JNI 已独立升级到 r29。32 位不再需要 NDK 21。只需打包 App 时不必运行该脚本，两套 ARM ABI 也不需要 yasm。完整命令和 API 21、pkg-config 隔离说明见 webhome-devkit/docs/应用完整开发文档.md。

APK 输出路径

debug 原始输出：

app/build/outputs/apk/mobileArm64_v8a/debug/app-mobile-arm64_v8a-debug.apk
app/build/outputs/apk/mobileArmeabi_v7a/debug/app-mobile-armeabi_v7a-debug.apk
app/build/outputs/apk/leanbackArm64_v8a/debug/app-leanback-arm64_v8a-debug.apk
app/build/outputs/apk/leanbackArmeabi_v7a/debug/app-leanback-armeabi_v7a-debug.apk

release 构建完成后会自动复制到 Release/apk/，Gradle 原始输出仍在 app/build/outputs/apk/<flavor>/release/：

Release/apk/mobile-arm64_v8a.apk
Release/apk/mobile-armeabi_v7a.apk
Release/apk/leanback-arm64_v8a.apk
Release/apk/leanback-armeabi_v7a.apk

安装到已连接设备：

adb devices
adb install -r app/build/outputs/apk/mobileArm64_v8a/debug/app-mobile-arm64_v8a-debug.apk

GitHub 手动发布

仓库内置 .github/workflows/android-release.yml,只支持在 GitHub Actions 页面手动触发,不会在每次 push 代码时自动打包。默认 tag 会从 app/build.gradle 读取当前 versionName,并使用当前提交的提交时间生成可重入 tag:稳定版生成 v<versionName>-yyyyMMddHHmm;在 fongmi-sync 分支选择 auto 通道时生成测试版 v<versionName>-beta-yyyyMMddHHmm,APK/JSON 文件名同步追加 -beta。

工作流会构建 4 个 release APK,生成同名更新清单 JSON 并发布到 GitHub Release。JSON 默认使用 GitHub Release 固定版本直链，不依赖 CNB 可用性。每次发布还会把当前通道的 4 个 JSON 与最近一次另一通道的 JSON 汇总后覆盖上传到固定的 update-channel 预发布 Release；手机版和电视版的稳定版、测试版清单都优先从该 GitHub Release 下载路径获取并使用同一套加速源，GitHub Releases API 仅作为最终兜底。CNB 同步默认关闭，仅在确认内容权利、平台政策和流量用途后作为可选镜像手动开启。正式发布前建议在 GitHub Secrets 配置:

RELEASE_KEYSTORE_BASE64  # release keystore 的 base64 内容
RELEASE_KEY_ALIAS        # key alias
RELEASE_STORE_PASSWORD   # store password,key password 复用该值
RELEASE_KEY_PASSWORD     # 可选,key password 与 store password 不同时配置
CNB_TOKEN                # 可选，CNB 镜像令牌；仅存 GitHub Secret，需仓库读写权限

CNB 可选镜像默认目标为 https://cnb.cool/fish2035/webhtv-release.git,仓库标识为 fish2035/webhtv-release。CNB Release Sync 手动补同步时可通过输入参数临时指定其他仓库。同步脚本只会在 CNB 镜像仓库内将 JSON 改写为 https://cnb.cool/<slug>/-/releases/download/<tag>/<apk>；GitHub Release 中的 JSON 仍指向 GitHub。

GitHub Actions 正式发布必须配置签名 secrets,否则会直接失败,避免使用 runner 临时 debug key 生成无法覆盖安装的 APK。

如果 CNB 同步失败,不需要重新打包，GitHub Release 和应用更新清单仍可独立使用。修正 CNB_TOKEN 或网络问题后,在 GitHub Actions 手动运行 CNB Release Sync,填写已有 release_tag 即可补同步；release_tag 留空时同步最新 release。令牌不得写入仓库、日志或 workflow 参数；曾在聊天、issue 或日志中暴露的令牌必须立即吊销。

签名

默认不需要配置 release 签名文件。未配置签名时，release 包使用 debug signing 兜底，方便 clone 后直接打包测试。

如需正式签名，在根目录的 local.properties 增加以下字段；keyPassword 可省略，省略时复用 storePassword：

sdk.dir=/path/to/android/sdk
storeFile=/path/to/keystore.jks
keyAlias=your_alias
storePassword=your_password
keyPassword=your_key_password

播放层依赖

app/libs/*.aar:内置 Hook、TVBus、Thunder、ForceTech、JianPian 播放能力依赖。
third_party/maven:已生成的 androidx.media3:*:1.11.0-alpha01-fongmi 本地 Maven 产物，以及定制 nextlib-media3ext。
third_party/media-lock.json:记录 Media3、nextlib、FFmpeg、NDK 与 CMake 的精确构建输入，配套脚本为 scripts/build_media_deps.sh。
third_party/patches/media3-*.patch:在锁定的 FongMi Media3 源码上叠加本项目补丁；media3-upstream-playback-fixes-2026-08.patch 选择性移植 AV1/HEVC HDR 元数据、scrub、DASH、LL-HLS、MP4 IT.35、MediaSession 和 detached Surface 等上游修复，media3-danmaku-live.patch 提供 WebSocket 实时弹幕的批量接收、有界队列、TTL、每帧处理上限和聚合统计。
third_party/patches/nextlib-*.patch:在 anilbeesetti/nextlib@6ff6cf9d0820382b3c233d018c52e4163b09d345 上叠加 FFmpeg 软解负载控制和 AV3A/libarcdav3a 支持。
third_party/mpv-native-lock.json、third_party/mpv-native-overrides/、third_party/patches/mpv-*.patch:固定 MPV/FFmpeg/libplacebo 原生栈，并维护单一低负载 Vulkan AImageReader 实现；配套脚本为 scripts/build_mpv_native.sh 和 scripts/verify_mpv_native_assets.sh。
third_party/mpv-player-jni:MPV libplayer.so JNI 桥接源码，修改后用 scripts/build_mpv_player_jni.sh 重建。
app/src/*/assets/mpv-libs/*:随 APK 打包的 MPV native 库和 JNI 桥接库。
nextlib-media3ext:io.github.anilbeesetti:nextlib-media3ext:1.10.0-0.12.1-fongmi-softload-av3a-r1，提供 FFmpeg renderer；内置 FongMi FFmpeg 04482c8d13ac27b2a9fe93f5d388929eef8af5f4 和静态链接的 libarcdav3a，Exo 可软解 audio/av3a，并在输出设备不接受源多声道 PCM 时下混到立体声。

settings.gradle 中的依赖顺序是仓库本地 third_party/maven、Maven Central、Google Maven、app/libs 和 JitPack。app/build.gradle 会强制所有 androidx.media3 依赖使用 1.11.0-alpha01-fongmi，避免传递依赖拉回官方版本。

普通 App/CI 构建直接使用仓库内已经提交完整的 Media3 AAR、POM、module 和校验文件，不会现场拉取或编译 Media3 源码。只有修改 third_party/patches/media3-*.patch、Media3 fork 或锁定版本后，才需要重建本地 Maven 产物：

scripts/build_media_deps.sh
bash gradlew :app:testMobileArm64_v8aDebugUnitTest --tests 'com.fongmi.android.tv.player.danmaku.*'
bash gradlew :app:assembleMobileArm64_v8aDebug :app:assembleLeanbackArm64_v8aDebug

脚本会按 third_party/media-lock.json 检出锁定提交、应用全部 Media3 补丁并发布到 third_party/maven。上游播放器修复及其精确移植方式记录在 lock 和相关仓库提交审计中；media3-danmaku-live.patch 还包含 Media3 渲染侧 Robolectric 压力测试。App 测试使用 MockWebServer 模拟 WebSocket，MockWebServer 仅属于 testImplementation，不会进入正式 APK。发布 GitHub Action 会先运行完整 WebSocket 弹幕单测，再构建四个 release APK。

只重建 nextlib/FFmpeg AV3A 扩展时使用：

export ANDROID_HOME="$HOME/Library/Android/sdk"
scripts/build_media_deps.sh --nextlib-only

该命令使用 NDK 28.2.13676358、CMake 3.22.1 为 arm64-v8a 和 armeabi-v7a 重编 FFmpeg/libarcdav3a，校验两端 libavcodec.so 的 AV3A 标记后发布到 third_party/maven。真实样片来源、SHA-256、实机步骤和验收结果见 Exo AV3A 验收记录。

常见构建失败

Unsupported class file major version、invalid source release: 21：当前终端没有使用 JDK 21。
Chaquopy ... is not a valid Python 3.10 command：安装主机 Python 3.10，并确保当前终端能执行 python3.10 --version。
SDK location not found：缺少 local.properties，或 sdk.dir 指向错误。
failed to find target with hash string 'android-37'：未安装 Android SDK Platform 37。
NDK clang++ not found：重建 MPV/JNI 时确认已安装 29.0.14206865，重建 IJK/DVD 时确认已安装 28.2.13676358，并检查 ANDROID_NDK_HOME 是否与对应 lock 一致。
Missing MPV asset directory：MPV assets 缺失或 ABI 目录名不匹配，确认 app/src/arm64_v8a/assets/mpv-libs/arm64-v8a 和 app/src/armeabi_v7a/assets/mpv-libs/armeabi-v7a 存在。
missing llvm-readelf/readelf：运行完整 MPV assets 校验时缺少 ELF 工具；Linux 安装 binutils，macOS 安装 NDK 29.0.14206865 或设置 ANDROID_NDK_HOME。
运行后提示 dlopen failed、libplayer.so 或 libmpv.so 相关错误：先确认对应 ABI 的整套 MPV/FFmpeg .so 已打包，并用 NDK llvm-readelf -d 检查 SONAME/DT_NEEDED。只有 JNI 或 client API 变化才运行 scripts/build_mpv_player_jni.sh；该脚本不能修复不配套的 libmpv.so、FFmpeg 或 libplacebo。
Could not resolve ...：依赖下载失败，检查网络或设置代理后重新执行 Gradle。
Permission denied: ./gradlew：本仓库文档统一使用 bash gradlew，不依赖可执行位。

目录结构

app/          Android 主应用(mobile/leanback 双 flavor)
catvod/       CatVod 抽象层、Spider 接口、网络和代理工具
quickjs/      JavaScript Spider 运行时
chaquo/       Python Spider 运行时
webhome-devkit/ WebHome 开发套件(文档、主页/扩展示例、模板、AI skills)
scripts/      Media3、MPV native/JNI、IJK/DVD 的构建与资产校验脚本
third_party/  本地 Maven、native 锁、补丁、override、nextlib 与 MPV JNI 源码
Release/      release 构建的 APK 输出
other/        Logo 图片和辅助工具

上游基线

仓库	分支	Commit
TV	`fongmi`	`1a19fee278fa2234da725d61a53bf59b69fe9127`（`560 / 5.6.0`）
FFmpeg	`release-9.0-fongmi`	`04482c8d13ac27b2a9fe93f5d388929eef8af5f4`
mpv-android	`fongmi`	`99a60ad2141d5ace94453590903c2c6b9a0a2443`
media	`release`	`2bc207851df311340767e913931ca7b28cab1794`
mpv	`fongmi`	`cca559b41ceb0bb7731cf6ef2e1f33276cd30c42`
libplacebo	`fongmi`	`b694a21bf2dc176c1e98b8a13c6421a0de5f3da5`
CatVodSpider	`main`	`a511a606a287089dffdd8374db75d95ec5f372b6`

机器可读记录见 third_party/fongmi-repositories-lock.json。

免费声明与社区分享

WebHomeTV 是基于开源生态二次开发的技术学习与研究项目,软件本体完全免费,不提供任何付费服务、影视内容、直播源、接口源、资源存储或内容分发能力。

本软件仅供技术学习、研究和个人测试使用,请在下载、安装或试用后 24 小时内自行卸载。继续使用本软件所产生的一切行为及后果,由使用者自行承担。

本软件不内置、不售卖、不传播任何影视资源,不对用户自行添加的接口、站源、插件、脚本、链接、网盘资源或第三方服务内容负责。使用者应遵守所在地法律法规,尊重版权方和内容提供方的合法权益,不得将本软件用于任何侵权、盗版、传播非法内容或其他违法违规用途。

严禁任何个人或组织以本软件名义进行售卖、引流、收费维护、会员服务、广告变现、盒子预装、电视盒子捆绑销售或其他任何形式的获益行为。对于将本软件内置于电视盒子、机顶盒、付费套餐或商业服务中进行销售、推广的行为,项目方明确反对并予以谴责。

Name		Name	Last commit message	Last commit date
Latest commit History 2,530 Commits
.github		.github
app		app
catvod		catvod
chaquo		chaquo
docs		docs
gradle		gradle
other		other
plans		plans
quickjs		quickjs
scripts		scripts
serverless		serverless
third_party		third_party
webhome-devkit		webhome-devkit
.gitattributes		.gitattributes
.gitignore		.gitignore
CODE_REVIEW_REPORT.md		CODE_REVIEW_REPORT.md
CONTROL_BAR_FIX_SUMMARY.md		CONTROL_BAR_FIX_SUMMARY.md
CRASH_ROOT_CAUSE.md		CRASH_ROOT_CAUSE.md
DETAIL_PAGE_MODES.md		DETAIL_PAGE_MODES.md
EPISODE_CACHE_IMPLEMENTATION.md		EPISODE_CACHE_IMPLEMENTATION.md
FFMPEG_MODE_SWITCH.md		FFMPEG_MODE_SWITCH.md
FOCUS_NAVIGATION_DEBUG.md		FOCUS_NAVIGATION_DEBUG.md
LANDSCAPE_VOLUME_GESTURE_FIX.md		LANDSCAPE_VOLUME_GESTURE_FIX.md
LICENSE.md		LICENSE.md
MOBILE_DETAIL_BUTTON_FINAL.md		MOBILE_DETAIL_BUTTON_FINAL.md
NIGHT_MODE_ANTI_FLASH_DESIGN.md		NIGHT_MODE_ANTI_FLASH_DESIGN.md
README.md		README.md
ROOT_CAUSE_ANALYSIS.md		ROOT_CAUSE_ANALYSIS.md
SHORT_DRAMA_SPEED_FIX.md		SHORT_DRAMA_SPEED_FIX.md
STACK_TRACE_ANALYSIS.md		STACK_TRACE_ANALYSIS.md
TMDB_ERROR_HANDLING_FIXES.md		TMDB_ERROR_HANDLING_FIXES.md
TMDB_FIX_PROGRESS.md		TMDB_FIX_PROGRESS.md
TMDB_FIX_SUMMARY.md		TMDB_FIX_SUMMARY.md
TMDB_PLAYER_FEATURES_COMPLETE.md		TMDB_PLAYER_FEATURES_COMPLETE.md
build-tv-debug.sh		build-tv-debug.sh
build.gradle		build.gradle
build_min.sh		build_min.sh
fix-episode-gap-numbering.patch		fix-episode-gap-numbering.patch
gradle.properties		gradle.properties
gradlew		gradlew
gradlew.bat		gradlew.bat
settings.gradle		settings.gradle
stacktrace.txt		stacktrace.txt
智能去广-设计文档.md		智能去广-设计文档.md

Navigation Menu

Repository files navigation

WebHomeTV

增强功能

效果演示

文档

构建

环境要求

从零 clone 到打包

常用本地打包命令

MPV native/JNI 重建

IJK native/FFmpeg 重建

APK 输出路径

GitHub 手动发布

签名

播放层依赖

常见构建失败

目录结构

上游基线

免费声明与社区分享

友情链接

About

Releases

Packages

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

WebHomeTV

增强功能

效果演示

文档

构建

环境要求

从零 clone 到打包

常用本地打包命令

MPV native/JNI 重建

IJK native/FFmpeg 重建

APK 输出路径

GitHub 手动发布

签名

播放层依赖

常见构建失败

目录结构

上游基线

免费声明与社区分享

友情链接

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages