TIGRIS · ANDROID TV LAUNCHER

让电视桌面, 重新惊艳。

把熟悉的 Android TV 换成 tvOS 般的沉浸入口。沉底的液态玻璃 Dock、会呼吸的顶部内容,还有 Apple TV 航拍视频做屏保——Tigris 把客厅的那块屏幕,重新变回它该有的样子。

  • Android TV 9+
  • 不需要 Root
  • 部分功能因电视品牌而异

实拍录屏 · Sony BRAVIA XR-55A80J · Android TV 12 1280 × 720

独立开源项目,与 Apple 无任何关联。「Apple TV」为 Apple Inc. 的商标。

索尼 BRAVIA 实机验证Apple TV 航拍屏保标准版 / 守护版两个 APK不需要 Root,随时可回退
v2.0.28 · 正式版更新 ↗
01

设置分组,一眼找到。

主屏幕设置首页只列分组:主屏幕、外观、壁纸、屏保、应用、系统……每组一页短列表,返回时回到原来那一行。设置项一个不少。

02

一块会发光的时钟。

屏保新增时钟:霓虹、翻页、液晶、极简,多种配色,可显示秒、加飘雪或星光。霓虹亮起有“滋”的电流声,秒针声音可开关。左右换样式,上下换颜色。

03

图标,换成你喜欢的。

长按 App 选择「更换图标」,用手机扫码上传图片:横版铺满,方形居中。随时恢复默认。

霓虹时钟屏保:粉色小时与青色分钟灯管,下方有倒影
Sony BRAVIA 实机截图 · 霓虹时钟屏保(本地签名测试构建)

EXTREME LIQUID GLASS

让玻璃融进画面,而不是盖住画面。

可选的「极致液态玻璃」:静态壁纸呈现细腻边缘折射与自适应着色;动态视频壁纸下,Dock 和控制中心直接透出原画面。进入设置、更换壁纸或切换顶部内容预览时,玻璃与背景同步变化,滚动时的绘制开销也更低。

索尼电视实拍:静态壁纸上的极致液态玻璃 Dock。
静态壁纸 · 细腻折射
索尼电视实拍:动态壁纸下的透明 Dock 和控制中心。
动态壁纸 · 透明 Dock 与控制中心
可选功能 · 默认关闭

均为 Sony BRAVIA Android 12 实机截图。本次性能测量限 Sony XR-55A80J,其他机型未验证;空闲唤醒后的按键首帧仍偶有延迟。动态视频使用透明材质,而非逐帧光学折射,可随时关闭。

实机验证说明

FILM

会发光的时钟屏保。

Tigris 2.0.28:霓虹、翻页、液晶、极简四种时钟,分组整理的设置,以及换成你喜欢的图标。全部在电视上实拍,点击播放,开启声音。

Music by Bensound.com/royalty-free-music
Track: “Hey!” · Artist: Benjamin Tissot
License code: 4M6F0T3L0S2JINDK

42 秒,认识 Tigris。

Music by Bensound.com/royalty-free-music
Artist: Marcus P.
License code: 55KIM7QUNXBISK9H

AERIAL SCREENSAVER

Apple TV 航拍,成为你的屏保。

Tigris 桌面或设置页面空闲后,电视缓缓滑过地球:海岸线、冰川与城市在屏保里依次展开,地点名随镜头变化。左右键切换镜头,断网自动回到照片。系统也能在明确暂停的前台播放器上启动屏保;正在播放的视频和已识别的投屏始终优先。

电视实录 · 航拍正在播放

在新西兰上空拥抱日出 · Sony BRAVIA 实录

  • 可选「航拍视频」作为屏保内容,画面来自 Apple 服务器在线播放(约 15–20 Mbps)
  • 断网或缓冲失败时自动切回照片屏保,不影响下一次空闲进入
  • 桌面或设置等页面空闲后可显示相框;第三方视频须确认暂停,播放中和已识别投屏不会被屏保打断

航拍视频由 Apple 的服务器在线提供,Tigris 不包含任何视频文件;「Apple TV」为 Apple Inc. 的商标。本项目与 Apple 无关联。

FEATURES

为十英尺距离重画一遍。

不是把手机界面放大,而是为客厅重新排版:更大的焦点、更少的层级、更安静的玻璃。

01LIQUID GLASS DOCK

沉下去的玻璃,浮起来的图标

第一排 App 坐在一块沉底的玻璃板上,下一排只露出上沿。按下键展开全部 App;平时,把画面还给壁纸。

  • 5 列 16:9 圆角图标,选中时放大、倾斜、带投影
  • 长按进入编辑,用方向键把图标拖进 Dock 或任意位置
  • 下滑渐入磨砂背景,Dock 与右上角随列表自然滑出屏幕
主屏幕 · 索尼 BRAVIA 实拍

02TOP SHELF

选中一个 App,上半屏开始播放它的世界

焦点落在 Dock 里的部分 App 时,上半屏轮播它的内容:正在直播的直播间、正在热门的视频,而不是一张静态海报。

  • 云视听小电视和第三方哔哩哔哩客户端:热门视频
  • 斗鱼:正在直播的热门直播间
  • 设置里可以填一个 JSON 地址,挂到一个 Dock 应用上
  • Jellyfin / Emby 的原生接口不是这个格式,需要一层转换
顶部内容 · 云视听小电视热门视频

03CONTROL CENTER

按一下返回键,控制中心浮出来

没有整块底板,只有一组独立悬浮的液态玻璃按钮。背后是实时模糊的桌面,前面是你此刻真正需要的开关。

  • 网络、待机、关机、重启、释放内存、相框、设置
  • 亮度、音量与 HDMI 输入源按电视能力自动出现
  • 提前准备背景采样,玻璃控件自然淡入
控制中心 · 独立悬浮玻璃按钮

04WALLPAPER & FRAME

电视不响的时候,让它成为一扇窗

必应每日风景、Wallhaven 全年龄热门、手机上传的照片、自己的图片链接,或者一组纯色渐变。每 15 分钟到一天换一张。

  • 相框缓慢平移缩放,时间文字定时挪位,照顾 OLED
  • 也可以换成 Apple TV 航拍视频,详见上一节
  • 桌面或设置页空闲时可进入;第三方播放器须确认暂停,正在播放和已识别投屏不会被覆盖
航拍屏保 · 电视实际播放录屏

BEFORE / AFTER

左右滑动,看见改变。

左边是用户提供的国产电视桌面截图,右边是 Tigris 的电视实录。拖动分界线,看看两种桌面的不同。

安装前国产电视 · 截图动态展示
安装后Tigris · 电视实录
拖动、点击或聚焦把手后用 ← → 调整,Shift 加速,双击回到中间。 左侧为用户提供的截图的动态展示,不是操作录像;两侧不是同一设备。

INSTALL

先准备两样东西。

  • 一台电脑,和电视连在同一个 Wi-Fi。
  • 一个能操作这台电脑的装在电脑上、能替你操作这台电脑的助手。例如 WorkBuddy、Codex、Claude Code、豆包电脑版、千问电脑版、Trae。只会聊天的手机网页做不到。:它会在你的电脑上亲自安装,而不是只把步骤发给你。

下面的小图是示意图,按菜单名字绘制,不是电视照片。

选出你的电视。

点下面的一个品牌。

卡住了?
  • 小米和红米菜单相同,机身上写红米就点红米。雷鸟和 TCL 不是同一个牌子,打开调试的按法相同。
  • 海信的 Android 电视、以及原生 Android 电视,点「其他 Android 电视」。
  • LG 的LG 电视的系统。不能用这一页的安装。请打开这一页。三星的三星电视的系统。不能用这一页的安装。不能从这里安装。

按主页键还是原来的

装好之后按画着房子的键,画面还是原来的桌面时,按下面的顺序做。一步只做一件事。

一位用户在索尼 BRAVIA XR-55A80K(Android 12,Google TV)上验证了 v2.0.15:设成默认桌面后,主页键回到 Tigris,HDMI 切换、亮度和音量都能用,其他索尼型号可能不一样。

  1. 先看是不是闪一下就回来了。

    你现在应该看到: 小米和红米会先闪一下原来的桌面,大约半秒,然后回到 Tigris。这是正常的,不用再修。

  2. 如果一直停在原来的桌面,把电视上的四段数字换进下面的命令,在安装时用的那台电脑上运行。

    curl -fsSL https://raw.githubusercontent.com/lesnolie/Tigris/main/install.sh | TV=192.168.1.20 bash -s -- repair

    你现在应该看到: 电脑上出现 mFocusedApp,并且里面有 com.leslie.tvhome。这是修复,不会卸载,也不会关掉自带桌面。

  3. 在电视上打开 Tigris 的设置,进入「桌面守护」,先关掉,再打开。

    你现在应该看到: 这一行变成「开」。这一下会重新授权。

  4. 如果系统是 Android 13 或更新,并且上一步没有变成「开」,打开 Tigris 的应用信息,点「允许受限设置」。

    你现在应该看到: 允许之后,回到上一步,把桌面守护再开一次。

  5. 电视待机再亮起之后,按一次遥控器上画着房子的键。

    你现在应该看到: 画面回到 Tigris。只按一次即可。

  6. 如果还是不行,看是不是下面这两种机器。

    你现在应该看到: 有的 TCL、雷鸟会大约每一分钟清掉无障碍,例如雷鸟 75S78A Plus。坚果 S621 也修不好。这两种不要反复重装。

  7. 不要自己关掉自带桌面。

    你现在应该看到: 关掉以后,有的电视会黑屏,遥控器也开不回来。自带桌面要留着。

不要自己关掉自带桌面。

这些词是什么意思

安装说明里会碰到的词,都在这里。

ADB 调试
让电脑通过家里的无线网络给电视安装应用的开关。菜单写成「ADB 调试」「USB 调试」或「网络调试」都是它。不用拆开电视。
IP 地址
电视在家里网络中的编号,四段数字用点分开,像 192.168.1.20。文档说大多数电视在「设置 → 网络」或「设置 → 关于」里。
确认键
遥控器正中间的圆键。文档里叫确认键,英文资料里常叫 OK。
开发者模式
多出来的一组设置。小米和红米要在「产品型号」上连按确认键,直到电视提示它已打开。
开发者选项
进入开发者模式之后,设置里多出来的菜单。调试开关在这里。
安装未知来源的应用
允许电视安装不是它自己的应用商店里下载的应用。小米和红米安装时需要打开它。
同一个 Wi-Fi
电脑和电视连的是家里同一个无线网络,不是手机流量。
AI
装在电脑上、能替你操作这台电脑的助手。例如 WorkBuddy、Codex、Claude Code、豆包电脑版、千问电脑版、Trae。只会聊天的手机网页做不到。
Android
一种电视系统。小米、红米、雷鸟、TCL 和索尼的智能电视多数是它。
webOS
LG 电视的系统。不能用这一页的安装。
Tizen
三星电视的系统。不能用这一页的安装。
VIDAA
海信的另一种系统。菜单如果和下面的步骤对不上,可能就是它,不能用这一页的安装。海信也有 Android 电视,那种可以。
多屏互动
TCL 和雷鸟电视自己弹出的安装确认。看到「多屏互动:正在发起应用推送」时,选「同意」。
主页键
遥控器上画着房子的键,有的上面写着 Home。按下去应该回到主屏幕。
开机广告
电视刚亮、任何主屏幕出现之前,系统自己播放的广告。文档写明它不属于桌面,不能承诺去掉。
推荐位
原厂桌面上的影片海报和应用推荐。Tigris 自己的主屏幕没有这一排。
弹窗广告
使用过程中突然跳出来的广告。每种品牌都还没有实机记录说它已经消失。
桌面守护
原厂桌面跳出来时,自动切回 Tigris。设置里用这个名字。安装时不用自己去打开。
自带桌面
电视出厂时的主屏幕。要留着,不要关掉。关掉以后,有的电视会黑屏。
始终允许
下次这台电脑再连接时,电视不再反复询问。文档要求勾上它,再选「允许」。
未实机验证
项目没有在真实电视上确认过这件事。
用户自报
某一位用户说自己的电视这样。项目没有再做官方测试。也可以叫社区反馈。

广告会怎样

停在 Tigris 主屏幕时没有原厂原厂桌面上的影片海报和应用推荐。Tigris 自己的主屏幕没有这一排。;电视刚亮、任何主屏幕出现之前,系统自己播放的广告。文档写明它不属于桌面,不能承诺去掉。在进主屏幕之前由系统播放,不能去掉;使用过程中突然跳出来的广告。每种品牌都还没有实机记录说它已经消失。还没测过。

上面那一句对每个品牌都一样,所以表里不再重复。没测过的广告都算未实机验证。没有已批准的固件可以自动关广告。若主页键仍停在自带桌面,推荐位还在。
电视和上面那句不一样的地方
小米 有的机器主页键仍打开自带桌面。MiTV-ANSP0、MiTV-ASTR0 是某一位用户说自己的电视这样。项目没有再做官方测试。也可以叫社区反馈。,只说明能否安装或运行。
红米 和小米同一套说明,没有单独记录。
雷鸟 75R685C 实机装成功,音量、设置、信号源可用。75S545C 是某一位用户说自己的电视这样。项目没有再做官方测试。也可以叫社区反馈。。
TCL 和雷鸟同一套说明,没有单独记录。
索尼 XR-55A80J 测过桌面、亮度、音量和信号源。
其他 Android 电视 海信 2026-10-26:某一位用户说自己的电视这样。项目没有再做官方测试。也可以叫社区反馈。用 WorkBuddy 装成功,没有型号。

换回原来的桌面

可以换回去。

复制下面的文字,发给帮你安装的那个装在电脑上、能替你操作这台电脑的助手。例如 WorkBuddy、Codex、Claude Code、豆包电脑版、千问电脑版、Trae。只会聊天的手机网页做不到。。

请阅读 https://github.com/lesnolie/Tigris/blob/main/AGENTS.md 里标题是 Restore 的部分(意思是:换回原来的桌面),在这台电脑上亲自做。 电视上的四段数字:(把电视上的四段数字填在这里) 把画着房子的键换回电视出厂时的主屏幕。先不要卸载 Tigris。不要猜原来的主屏幕叫什么名字。不要重启或关掉电视,除非我同意。 做完后用白话告诉我:我按画着房子的键,看到的是不是原来的主屏幕。

你现在应该看到: 对方开始把遥控器上画着房子的键,有的上面写着 Home。按下去应该回到主屏幕。换回电视出厂时的主屏幕。要留着,不要关掉。关掉以后,有的电视会黑屏。,并且先不删除 Tigris。

卡住了?
  • 要用安装时的那台电脑。换了一台电脑,就不能猜原来的主屏幕叫什么。
  • 只在 Tigris 里关掉原厂桌面跳出来时,自动切回 Tigris。设置里用这个名字。安装时不用自己去打开。,不会完整换回去。

如果助手不方便,Mac 或 Linux 可以自己粘贴文档里的 install.sh restore。它会关掉自动切回,把画着房子的键还给安装时记下的原来的桌面,并且先不卸载 Tigris。Windows 请用上面的文字。电脑需要 bash、curl,以及 adb(电脑用来连接电视的程序,在Android 平台工具里)。

curl -fsSL https://raw.githubusercontent.com/lesnolie/Tigris/main/install.sh | TV=192.168.1.20 bash -s -- restore
高级:自己用命令、手动步骤和完整限制

日常用上面的步骤即可。这里是同一套安装的详细版,只有要自己动手时才需要。先装好 Git、Python 和 adb,再用下面这一条命令。策略表只是对照,不是另一套步骤。逐条命令和长说明都在最下面。

按电视系统选择安装包(正式版 v2.0.20)

标准版文件:Tigris-v2.0.20.apk;兼容守护版文件:Tigris-guard-v2.0.20.apk。Guard 是不声明 HOME 的兼容模式,不代表全部 TCL 必须使用。

电视 / 系统选哪个区别与限制
Sony BRAVIA / 原生 Android TV、Google TV 标准版 优先使用系统默认 HOME;实体 Home、重启和待机需要验收。
TCL / 雷鸟 / FFalcon Android 标准版优先;固件拒绝 HOME APK 时用兼容守护版 验证器拒绝后才走官方 Guard + 多屏互动/T-Cast;Guard 不声明 HOME,需授权守护。
小米 / Redmi MIUI TV、HyperOS TV 标准版尝试 + 固件诊断 PatchWall 可能忽略第三方 HOME。不能禁用原厂桌面;Guard 也不保证成功。
创维 / 酷开、海信 / Vidda、OPPO、极米、康佳、乐视等 Android 9+ 标准版安全尝试 同品牌固件可能不同;未知机型先只读检测,不宣称已接管 Home。
LG webOS 独立 IPK 开发预览版 Android 标准版/Guard 均不能安装;预览版不接管 Home。
Samsung Tizen / 海信原生 VIDAA 均不支持 Android APK 不得执行 Android ADB 安装流程。

安装成功不等于 Home 接管。先在电视上打开另一个应用再按实体 Home,并测试重启、唤醒、清理内存。本版支持可配置 5/6 图标 Dock 和异步壁纸取帧;其他设备的 HOME 接管效果仍需反馈。

一条命令

INSTALL BY SYSTEM

选电视系统,再获取适用的安装方式。

正式 APK v2.0.20:Sony 和标准 Android TV 优先标准版;TCL / 雷鸟中拒绝 HOME APK 的固件使用兼容守护版 Guard。小米等特殊固件先诊断。其他机型是否真正接管 Home,仍以实体遥控器和待机测试为准。

只做安全安装及诊断,不猜测原厂组件或自动启用守护。

先装好这三样,再运行命令。Windows 还要安装 Git for Windows,并把 Git Bash 和 adb 加入 PATH。电脑和电视同一个 Wi-Fi。把第一行地址改成电视上的四段数字。

$tv = "192.168.1.20:5555"
$tigrisDir = Join-Path $env:TEMP ("tigris-" + [guid]::NewGuid().ToString("N"))
git clone --depth 1 --branch v2.0.20 https://github.com/lesnolie/Tigris.git $tigrisDir
if ($LASTEXITCODE -ne 0) { throw "Tigris source download failed" }
python (Join-Path $tigrisDir "tools/install-plan.py") --platform android --serial $tv

品牌选项用于说明差异;执行时读取电视的真实型号、固件与 HOME,再匹配统一策略库。安装不等于接管成功;实体 Home、开机与待机需分别验收。现有用户推荐在 Tigris 软件更新中覆盖升级,保留原安装包类型。 此处命令获取已发布 v2.0.20 安装器;机型细分诊断仅提供安全建议,具体固件仍需用户实测。

恢复原桌面:保留原电脑的安装快照,在源码目录按下方说明执行 install.sh restore;不要凭品牌猜原桌面组件。

安装前准备、专用安装与恢复说明 ↗

下面是装上之后的检查和排错,不是另一套安装步骤。

v2.0.7 · 未做实机测试,邀请红米 / 小米用户验证

本版修复待机唤醒动画前露出 Tigris 主页,以及进程恢复后守护服务未绑定的代码路径。请红米 X50 / MIUI 和有相同问题的小米 / Redmi 用户测试;系统强制停止或原厂桌面闪现不保证解决。

请分别测试:实体 Home、待机唤醒动画、长按 Home 清理内存后守护恢复,以及方便时的重启保持。反馈型号、MIUI / 固件版本、标准版或 Guard 版、动画模式和等待时间、每项通过 / 失败 / 未测试;闪屏请说明是 Tigris 还是原厂桌面,可附短视频。

反馈对应电视测试结果 ↗ · v2.0.7 更新说明 ↗

两种手动安装方式,同一套验收标准

A · 遥控器 / U 盘:下载正确 APK,安装并打开,按电视提供的默认桌面选择器设置。从其他应用按实体 Home 测试。仍回原桌面时,Tigris 仍可作为应用打开;完整接管可能需要 ADB 或专用适配。U 盘不会自动授予系统权限。

B · 电脑:按下面步骤安装后运行统一检查器。AI 安装使用同一检查器。检查会打开系统设置并发送 Home;安装、实体 Home、待机唤醒、重启分别报告,没测过就写未验证。

curl.exe -fsSL -o check-install.py https://raw.githubusercontent.com/lesnolie/Tigris/main/tools/check-install.py
python check-install.py verify --serial 192.168.x.x:5555 --report verification.json

先安装、再验证;失败才处理具体固件限制。Success、默认 HOME 解析或守护已启用,都不能代替实体 Home 验证。保留所有品牌的原厂桌面。

按电视品牌排查
Sony / Android TV默认桌面与实体 Home
Google TV默认 HOME 解析、原厂桌面是否重新打开
小米 / RedmiHome 失败才查固件包名筛选;唤醒失败另查待机清理与后台启动
TCL / 雷鸟先区分 APK 安装校验与 HOME 声明限制,再查守护和自启动
海信 Android / 创维酷开按固件检查 Home、后台启动和守护服务绑定
LG webOS独立 IPK 预览、Developer Mode 与 SSH;不使用 ADB,尚无 Home Helper

完整规则、检查结果与安全回退 ↗

策略对照

上面那条命令会读取电视的真实型号,再对照这张表。这不是另一套安装步骤。

策略实际路径
Sony 原生 HOME沿用标准版与原生 HOME,实际验收失败才使用既有守护。
TCL / 雷鸟兼容安装保留 Guard 及 T-Cast 特殊推送;只有确认固件限制后才切换,不卸载旧版绕过签名。
小米 / Redmi 固件诊断MIUI 与 HyperOS 名称不是兼容证据。先安全安装,再检查 HOME 候选、PatchWall 和 FallbackHome;接管试验须单独授权。
创维 / 酷开设备诊断检查此设备是否使用厂商 HOME.CC 或独立启动路径,首次只执行安装和只读检查。
海信 / Vidda Android 设备诊断确认系统确实是 Android,并检查该固件的 HOME 解析与启动路径。
OPPO ColorOS TV 设备诊断部分系统限制 HOME 应用安装,先识别安装错误与现有默认桌面。
极米 GMUI 设备诊断检查实际 ADB 授权和长按 Home 的清理行为。
康佳安装器与 HOME 检查检查文件管理器与系统安装器的差异,保留既有应用数据。
乐视 eUI 守护诊断检查后台进程被反复清理的情况,先让用户正常使用其他应用。
未知 Android 固件只做安全安装及诊断,不猜测原厂组件或自动启用守护。
不用上面的命令时,才按品牌逐条输入
不同品牌电视开启 ADB 调试的方式
电视怎么打开 ADB
小米 / Redmi 设置 → 关于 → 产品型号,连续按确认键进入开发者模式;再到 设置 → 账号与安全,打开 ADB 调试 和 安装未知来源的应用。
TCL / 雷鸟 设置 → 关于 → 本机信息,用遥控器依次按 上、下、左、右(间隔不超过 1 秒),底部出现「更多」,在其中打开 ADB。
索尼 BRAVIA 设置 → 系统 → 关于 → 在 版本 上连按确认键 7 次;再到 设置 → 系统 → 开发者选项,打开 USB 调试。
原生 Android TV / Google TV、海信等 设置 → 设备偏好设置 → 关于 → 连续按 版本号 7 次;再到 开发者选项,打开 USB 调试(也可能叫「网络调试」或「ADB 调试」)。

先选择电脑系统,查看对应的准备步骤;再选择电视品牌。下方命令会同步切换,按顺序逐条运行。

示例中的 192.168.x.x 是占位符,请换成电视的实际 IP;BRAVIA 注册步骤里的 PIN 是电视屏幕上显示的四位数字,请按提示替换。

Windows:打开 PowerShell

在开始菜单搜索 PowerShell 并打开。先安装 Android SDK Platform-Tools,并把 adb 加入 PATH;TCL 推送还需要 Python 3。运行下面的检查,再选择电视品牌。

adb version
curl.exe --version

TCL / 雷鸟还需运行 python --version,确认是 Python 3。

选择电视品牌,按顺序执行

索尼 BRAVIA

完整验证的路径,包括亮度、电视音量和 HDMI 输入源。下面以 192.168.x.x 代指电视 IP。

  1. 连接电视

    在电脑上运行;电视出现授权框时选「允许」并勾选「始终允许」。

    adb connect 192.168.x.x:5555
    adb -s 192.168.x.x:5555 get-state
  2. 记录原来的桌面、屏保与无障碍服务

    卸载时需要把它们恢复,请先保存到记事本。

    adb -s 192.168.x.x:5555 shell cmd package resolve-activity -a android.intent.action.MAIN -c android.intent.category.HOME
    adb -s 192.168.x.x:5555 shell settings get secure screensaver_components
    adb -s 192.168.x.x:5555 shell settings get secure enabled_accessibility_services
  3. 下载并安装标准版

    curl.exe -fsSL -o download-release.py https://raw.githubusercontent.com/lesnolie/Tigris/main/tools/download-release.py
    $apk = python .\download-release.py standard
    adb -s 192.168.x.x:5555 install -r $apk

    命令已适配上方选择的电脑系统。

  4. 设为默认桌面并授权

    三条权限分别用于:守护与屏保、被杀后复活、开机后台打开主屏幕。

    adb -s 192.168.x.x:5555 shell cmd package set-home-activity com.leslie.tvhome/.HomeActivity
    adb -s 192.168.x.x:5555 shell input keyevent KEYCODE_HOME
    adb -s 192.168.x.x:5555 shell pm grant com.leslie.tvhome android.permission.WRITE_SECURE_SETTINGS
    adb -s 192.168.x.x:5555 shell cmd notification allow_listener com.leslie.tvhome/com.leslie.tvhome.RevivalListener
    adb -s 192.168.x.x:5555 shell appops set com.leslie.tvhome SYSTEM_ALERT_WINDOW allow
  5. 可选:注册 BRAVIA IP 控制

    要用亮度、电视音量和 HDMI 输入源,需要注册一次。第一条命令后电视会显示 4 位 PIN,用它完成第二条。

    $body = '{"method":"actRegister","id":1,"version":"1.0","params":[{"clientid":"tvhome:1","nickname":"TVHome","level":"private"},[{"value":"yes","function":"WOL"}]]}'
    [System.IO.File]::WriteAllText((Join-Path (Get-Location) 'bravia-register.json'), $body)
    curl.exe -s http://192.168.x.x/sony/accessControl --data-binary '@bravia-register.json'
    # The TV now shows a 4-digit PIN. Replace PIN with it and run:
    curl.exe -s -u ":PIN" http://192.168.x.x/sony/accessControl --data-binary '@bravia-register.json'

    此步骤分两次执行;看到电视上的 PIN 后,再替换 PIN 执行第二次请求。

  6. 允许本机调试

    首次打开 Tigris 会请求本机调试授权,用于待机、关机、重启和彻底清理后台。电视上勾选「始终允许」,再打开控制中心确认不再显示「本机调试未授权」。

  7. 截图验证

    adb -s 192.168.x.x:5555 shell screencap -p /sdcard/tigris-check.png
    adb -s 192.168.x.x:5555 pull /sdcard/tigris-check.png tv.png

    应当看到右上角的紧凑时钟、两个圆形按钮,以及底部玻璃 Dock。

高级:这些权限具体做什么

安装命令里用 ADB 授予的三项权限,普通应用拿不到;它们只在设备本地生效,不联网传输任何内容。

权限用途
WRITE_SECURE_SETTINGS系统关闭守护后重新打开、把相框设为系统屏保、小米唤醒后保持 ADB 开启
通知监听(RevivalListener)被系统杀掉或开机后约半秒把 Tigris 重新拉起,不读取任何通知内容
SYSTEM_ALERT_WINDOW开机后从后台打开主屏幕;不做悬浮窗广告或覆盖
TCL APP_AUTO_START / APP_ASSOC_START只有 TCL 需要,允许第三方 App 开机自启
不要在没有询问的情况下远程关机或重启电视。电视一旦断电,只能用遥控器重新打开。安装流程不需要卸载或停用任何系统应用。

LG WEBOS · DEVELOPER PREVIEW

LG webOS:独立测试版 IPK。

Tigris 不会把 Android APK 伪装成 LG 安装包。LG 版采用独立 IPK、非 Root 与已有 Root 两套能力模块;自动跟随电视语言,天气卡片默认关闭。

标准 · 不需要 Root

LG Developer Mode 安装普通桌面,遥控器与 Luna 接口。Home Helper 需独立安全验证,目前未启用。Quick Access 可作快捷入口。

高级 · 已 Root 用户

只检查已有 Homebrew 权限,不自动 Root、不刷机、不改写 LG 原厂桌面。高级接管需要独立验证与可撤销能力。

天气 · 默认关闭

Open-Meteo、手动选择城市、30 分钟刷新与 6 小时离线缓存。关闭后不请求天气数据。

已提供 0.1.0 测试 IPK,未做 LG 实机测试,不是稳定版。普通安装不会接管 Home;请对应 LG 用户测试并反馈。

COMPATIBILITY

哪些功能,你的电视能用。

Tigris 会先尝试品牌接口,再退回 Android 标准接口。下表是当前实现的能力边界,而不是宣传口径。

Android TV 9+ · 标准版 / 守护版行为一致,仅桌面声明不同
功能任意 Android TV需要本机调试授权仅索尼 BRAVIA
主屏幕、Dock、玻璃效果、投影 支持 — —
顶部内容(B 站 / 斗鱼 / 自定义) 对应 TV 版 App,或自定义 JSON 地址 — —
风景 / 二次元背景、相框 支持 — —
Apple TV 航拍视频屏保 支持,需联网 — —
控制中心界面、时钟 支持 — —
释放内存 清理缓存 彻底结束后台 App —
删除预装 App — 支持 —
待机、关机、重启 — 支持 —
应用内相框倒计时(主屏幕);系统屏保可覆盖空闲设置页 支持 — —
相框设为系统屏保 — 支持 —
音量滑条 Android 标准音量 — 电视音量
HDMI 输入源切换 大多数电视 — 并显示当前输入源
亮度(背光)滑条 小米,需 ADB 授权 — 支持
桌面守护、被杀后自动复活 需电脑 ADB 授权一次 支持 —
本机调试授权是什么 Tigris 连接电视自己的 127.0.0.1:5555 执行系统命令。电视会弹出「允许调试吗?」,勾选「始终允许」即可,一次授权各品牌通用。
索尼 BRAVIA 注册 IP 控制后,亮度、音量和输入源都走电视自己的接口;输入源一栏还能显示当前信号。
TCL / 雷鸟国行固件 没有标准输入源注册,输入源会打开 TCL 自己的选择器;没有可用背光接口,亮度滑条隐藏;需用 guard 版。
小米 / Redmi 国行固件 背光走 picture_backlight,输入源走小米播放器;不要停用自带桌面,用桌面守护。
酷开 / 创维 没有标准输入源时,输入源会打开酷开桌面自己的信号源选择器;亮度和设置仍走 Android 标准接口。尚未实机验证。
其他品牌 音量用 AudioManager,输入源用 TvInputManager。Android 没有标准背光接口,亮度滑条会隐藏。每个品牌是 tv/ 目录里的一个适配器文件,欢迎提交你电视的适配。
功放 / ARC · eARC 标准音量控制的可能是电视本身而不是功放;CEC 音量行为取决于电视与功放固件。
验证范围:完整验证仅在索尼 BRAVIA XR-55A80J(Android TV 12)上完成。TCL / 雷鸟与小米的适配来自社区实机笔记,尚未由本项目逐台验证。

FAQ

安装之前,你大概会问。

需要 root 吗?会不会影响保修?

不需要 root,也不修改系统分区。标准版只是通过 ADB 把自己设为默认桌面,并授予几个普通应用拿不到的权限。

保修是否受影响取决于电视厂商的条款,本项目无法替你保证。真正的风险来自误用 ADB 命令,例如停用小米自带桌面导致黑屏。

怎么恢复原来的桌面?

优先按 README 的还原流程,默认保留 Tigris。先关闭守护,恢复记录的默认 HOME;仅当前屏保属于 Tigris 时恢复原屏保。下面检查命令的 ORIGINAL_PACKAGE/ORIGINAL_ACTIVITY 替换为保存的原桌面组件;验证失败不要卸载。

adb -s 192.168.x.x:5555 shell am broadcast -a com.leslie.tvhome.CONFIG -n com.leslie.tvhome/.ConfigReceiver --ez guard false --ez keep_adb false
curl.exe -fsSL -o check-install.py https://raw.githubusercontent.com/lesnolie/Tigris/main/tools/check-install.py
python check-install.py verify --serial 192.168.x.x:5555 --expected ORIGINAL_PACKAGE/ORIGINAL_ACTIVITY
为什么小米 / Redmi 不能停用自带桌面?

小米的 PatchWall(com.mitv.tvhome)由系统白名单强制接管主页键,停用后系统的兜底桌面同样拒绝第三方桌面,结果是开机黑屏。

Tigris 改用「桌面守护」:原厂桌面一到前台就把 Tigris 拉回来,大约闪半秒,不停用或卸载任何系统应用。

TCL / 雷鸟安装失败,提示 INSTALL_FAILED_VERIFICATION_FAILURE

这是 TCL 的安装校验在拒绝 adb 安装。请使用带版本号的守护版 APK(Tigris-guard-vX.Y.Z.apk),通过电视自带的「多屏互动」推送,命令见上方 TCL 标签页。

如果脚本连不上 6553 端口,说明该机型没有多屏互动服务,可以把 APK 推到 /sdcard/Download/,再用电视上的文件管理器安装。

为什么没有亮度滑条?

Android 没有调节背光的标准接口。索尼 BRAVIA 通过电视自己的 IP 控制接口提供亮度;小米国行固件可写 picture_backlight(需 ADB 授权)。其他品牌暂时失败时,滑条会隐藏而不是显示一个没有作用的控件。

用功放 / ARC、eARC 时音量为什么不对?

用标准的 Android 音量接口时,控制的可能是电视本身而不是功放。索尼可以改用电视侧的音量接口,CEC 音量行为最终取决于电视与功放固件。

ADB 一直提示 unauthorized 怎么办?

说明电视没有接受这台电脑的调试授权。请在电视上勾选「始终允许来自这台计算机」并点「允许」;小米每次唤醒会关闭 ADB,Tigris 的「保持 ADB 调试开启」可以在唤醒后自动打开。

桌面守护会不会读取我的屏幕或通知?

不会。守护只监听窗口切换,判断原厂桌面是否来到前台,不读取屏幕内容;通知监听只用于在系统杀掉 Tigris 后把它重新拉起,不读取任何通知。

怎么更新到新版本?

从 GitHub Releases 页面下载最新 APK,用 adb install -r 覆盖安装即可,设置和布局会保留。下载入口始终打开全部版本列表,不需要网站跟随版本更新。

网站和 App 会收集数据吗?

网站是纯静态页面,不使用 Cookie、不加载第三方统计或广告脚本,字体使用系统字体。

App 需要联网获取壁纸(必应、Wallhaven)与顶部内容(哔哩哔哩、斗鱼的公开网页接口)。自定义顶部内容只在你填写地址之后,由电视向该地址请求。选择航拍屏保时视频从 Apple 的服务器在线播放。没有账号体系。

和 Apple 有关系吗?

没有。Tigris 是独立的开源项目,与 Apple、Sony、小米、TCL、哔哩哔哩、斗鱼均无关联,也未获其认可。设计语言受 tvOS 启发,但不包含 Apple 的代码、字体或素材。

GET TIGRIS

让每一次打开电视,都值得期待。

下载 APK,打开 ADB,剩下的交给指南或一个 Agent。Android 9+,无需 root,随时可以回到原厂桌面。