lesnolie/Tigris

选用指南

AI 根据 README 整理 · 2026/10/21 08:01:35

适用场景

适用于希望将 Android TV 桌面改为类似 tvOS 26 风格的用户，支持自定义 Dock、顶部内容、控制中心和照片屏保。

查看 README 依据

# Tigris 把 Android TV 的桌面换成 tvOS 26 的样子：沉底的 Liquid Glass Dock、Top Shelf 式的顶部内容、毛玻璃控制中心、风景照片背景和相框屏保。 > 十二生肖开源系列第三个项目：虎。Tigris 是拉丁语和希腊语里的"老虎"。 **已在索尼 BRAVIA XR-55A80J（Android TV 12）上完整验证。** 其他品牌的电视，交给 AI Agent 按 [AGENTS.md](AGENTS.md) 安装和适配，见下文。  ## 效果图 | 顶部内容（Top Shelf） | 展开全部 App | |---|---| |  |  | | **控制中心** | **相框 / 屏保** | |  |  | ## 让 AI Agent 帮你安装 把下面这句话和仓库链接发给 Codex、Claude Code 这类能执行命令的 Agent 即可：

目标用户

面向 Android TV 用户，特别是索尼 BRAVIA 用户，也支持其他品牌电视，但可能需要适配。

查看 README 依据

# Tigris 把 Android TV 的桌面换成 tvOS 26 的样子：沉底的 Liquid Glass Dock、Top Shelf 式的顶部内容、毛玻璃控制中心、风景照片背景和相框屏保。 > 十二生肖开源系列第三个项目：虎。Tigris 是拉丁语和希腊语里的"老虎"。 **已在索尼 BRAVIA XR-55A80J（Android TV 12）上完整验证。** 其他品牌的电视，交给 AI Agent 按 [AGENTS.md](AGENTS.md) 安装和适配，见下文。  ## 效果图 | 顶部内容（Top Shelf） | 展开全部 App | |---|---| |  |  | | **控制中心** | **相框 / 屏保** | |  |  | ## 让 AI Agent 帮你安装 把下面这句话和仓库链接发给 Codex、Claude Code 这类能执行命令的 Agent 即可：

- **索尼**：电视有 BRAVIA IP 控制接口（`http://127.0.0.1/sony/`）时，亮度、音量和输入源都走这个接口。 - **其他品牌**：自动改用 Android 标准接口。音量用 `AudioManager`；输入源用 `TvInputManager` 列出 HDMI 口，再交给系统的电视播放器切换。Android 没有调背光的标准接口，所以亮度滑条会隐藏。用功放（ARC/eARC）时，标准音量调的可能是电视本身而不是功放。 ### 国产电视（非原生 Android TV 系统） 小米、TCL、海信、创维等国产电视大多只认自家桌面：按主页键会回到自带桌面，待机时还会清理第三方 App。我们没有这些电视，没法验证，所以 App 里没有内置对付它们的功能。[AGENTS.md](AGENTS.md#10-tvs-whose-system-fights-third-party-launchers) 里写了一套按"先温和、后强硬"排列的处理办法，全程不需要 root，也不卸载、不停用系统应用；Agent 会在你的电视上逐层尝试，哪一层管用就停在哪一层。 ### 想兼容其他品牌电视

使用方式

可通过 AI Agent 自动安装，或手动构建 APK 并使用 adb 安装和设置默认桌面。

查看 README 依据

> 按 https://github.com/lesnolie/Tigris 的 AGENTS.md 把 Tigris 装到我的电视上，电视 IP 是 192.168.x.x Agent 会按 [AGENTS.md](AGENTS.md) 一步步完成：连接电视、安装、设为默认桌面、授权，以及索尼电视的额外配置。过程中电视上会弹出两三次确认框，需要你用遥控器点"允许"。 ## 功能 - **主屏幕**：大号细体时钟和日期，5 列 16:9 圆角图标。选中时图标放大、倾斜并带投影。 - **编辑主屏幕**：长按图标进入编辑，用方向键把它拖到任意位置，拖进 Dock 就成了常用 App，和 iPhone、Apple TV 的排列方式一样。 - **删除 App，包括预装的**：长按菜单可以直接删除 App，连电视预装、系统设置里删不掉的也可以（`pm uninstall --user 0`，系统分区里的安装包还在）。删掉的预装 App 不再出现，也不会在后台运行；随时可以在"主屏幕设置 → 已删除的预装 App"里恢复。电视运行必需的组件（设置、电视播放器、输入源、桌面）不提供删除。

这三项都在 [`TvControls.kt`](app/src/main/java/com/leslie/tvhome/TvControls.kt) 里：先试索尼接口，不行再用 Android 标准接口。要支持某个品牌自己的接口（比如背光），在这里加一个分支就行。 不会写代码也没关系。把下面这句话发给 Agent，它会按 [AGENTS.md 的"适配"一节](AGENTS.md#9-adapting-tigris-to-a-tv-that-isnt-fully-supported)，在你的电视上查找可用的接口、改代码、编译、安装并验证： > 按 https://github.com/lesnolie/Tigris 的 AGENTS.md 安装 Tigris，如果亮度/音量/输入源在我的电视上不能用，帮我适配。电视 IP 是 192.168.x.x 适配成功后，欢迎提交 PR，让同品牌的人都能用上。 ## 手动构建和安装 需要 JDK 17 和 Android SDK（compileSdk 36）。也可以直接下载 [Releases](https://github.com/lesnolie/Tigris/releases/latest) 里的 APK。 ```sh ./gradlew assembleRelease adb connect <电视IP>:5555

部署要求

需要 Android TV 9+ 设备，部分功能需要开启网络调试或 ADB 调试，索尼电视需注册 BRAVIA 客户端。

查看 README 依据

| 功能 | 任意 Android TV（Android 9+） | 需要本机调试授权 | 仅索尼 BRAVIA | |---|:-:|:-:|:-:| | 主屏幕、Dock、玻璃效果、投影 | ✅ | | | | 顶部内容（B站 / 斗鱼） | ✅ 需要装对应的 TV 版 App | | | | 风景 / 二次元背景、相框 | ✅ | | | | 控制中心界面、时钟 | ✅ | | | | 释放内存 | ✅ 只能清理缓存 | ✅ 彻底结束后台 App | | | 删除预装 App | | ✅ | | | 待机、关机、重启 | | ✅ | | | 把相框设为系统屏保、空闲时长 | | ✅ | | | 音量滑条 | ✅ Android 标准音量 | | ✅ 电视音量 | | HDMI 输入源切换 | ✅ 大多数电视 | | ✅ 还能显示当前输入源 | | 亮度（背光）滑条 | | | ✅ | - **本机调试授权**：App 会连接电视自己的 adb（`127.0.0.1:5555`，基于 [dadb](https://github.com/mobile-dev-inc/dadb)）来执行系统命令。前提是电视在开发者选项里打开了"网络调试 / ADB 调试"。首次使用时电视会弹出"允许调试吗？"，勾选"始终允许"即可。这个机制在各品牌电视上都通用。

adb install -r app/build/outputs/apk/release/app-release.apk adb shell cmd package set-home-activity com.leslie.tvhome/.HomeActivity # 设为默认桌面 ``` 索尼电视要用亮度、音量和输入源，还需要注册一次 BRAVIA 客户端： ```sh BODY='{"method":"actRegister","id":1,"version":"1.0","params":[{"clientid":"tvhome:1","nickname":"TVHome","level":"private"},[{"value":"yes","function":"WOL"}]]}' curl -s http://<电视IP>/sony/accessControl -d "$BODY" # 电视屏幕上会显示 4 位 PIN curl -s -u ":<PIN>" http://<电视IP>/sony/accessControl -d "$BODY" # 用这个 PIN 完成注册 ``` 注册之后 App 会自动续期授权。客户端 ID 是固定的，只有你家局域网里的设备能用它，外网访问不到。

已知限制

国产电视（如小米、TCL）可能无法完全兼容，亮度滑条在非索尼电视上隐藏，音量控制可能不适用于功放。

查看 README 依据

- **索尼**：电视有 BRAVIA IP 控制接口（`http://127.0.0.1/sony/`）时，亮度、音量和输入源都走这个接口。 - **其他品牌**：自动改用 Android 标准接口。音量用 `AudioManager`；输入源用 `TvInputManager` 列出 HDMI 口，再交给系统的电视播放器切换。Android 没有调背光的标准接口，所以亮度滑条会隐藏。用功放（ARC/eARC）时，标准音量调的可能是电视本身而不是功放。 ### 国产电视（非原生 Android TV 系统） 小米、TCL、海信、创维等国产电视大多只认自家桌面：按主页键会回到自带桌面，待机时还会清理第三方 App。我们没有这些电视，没法验证，所以 App 里没有内置对付它们的功能。[AGENTS.md](AGENTS.md#10-tvs-whose-system-fights-third-party-launchers) 里写了一套按"先温和、后强硬"排列的处理办法，全程不需要 root，也不卸载、不停用系统应用；Agent 会在你的电视上逐层尝试，哪一层管用就停在哪一层。 ### 想兼容其他品牌电视