tellyscope README

项目的 README,来自 github.com/man15h/tellyscope。合并为一个 markdown 文件:README.md。

Tellyscope

Debloat your Android TV, install apps, and browse and transfer files on it, all from your phone. No root, no PC.

3 MB No tracking No root 6 languages GPL-3.0 Latest release

Get the signed APK on GitHub Get it on Obtainium Get it on Orion Store

Google Play (testing)

Tellyscope is in closed testing on Google Play. Join the testers group, accept the test, then install it from Play. Play keeps this build updated, so it has no in-app update check, and it doesn't download launchers from GitHub.

Get it on Google Play (testing)

1. Join the group → 2. Accept the test → 3. Install from Play

Watch the demo

A TV's page: the TV at a glance, its vitals, and the Install, Debloat and Send buttons The Remote: Screen off and Restart under a menu in the top bar, a D-pad, icon keys for Back, Home, Menu, mute and volume, a keyboard key for typing on the TV, and along the bottom three streaming buttons, YouTube, Netflix and Jellyfin, then a key to open any app Debloat: the TV's model on top, then the apps it will turn off, each with its package name Updating Netflix on the TV from split APKs on the phone: the dialog says it updates the TV's copy from 11.2.0 to 11.3.0 and its settings stay
Your TV at a glance Control the TV from your phone Review every app Debloat turns off Install apps
Sending a video from the phone to the TV's Movies folder Tweaks: the Home screen card with Google TV Home as Current and Change home screen, then ad-blocking Private DNS on, faster animations and clear caches Make Projectivy Launcher the home screen: the confirm says Google TV Home, the TV's built-in launcher, is the only one ever turned off Advanced monitor, This TV: CPU, memory and storage rings, the network's last minute, and the TV's facts
Send files to the TV Block ads, tweak the TV, add a launcher Make a launcher Home Advanced monitor: the TV at a glance
Advanced monitor, CPU: the last minute's CPU use over the apps using it most Advanced monitor, RAM: memory in use over the apps holding the most Advanced monitor, Network: the TV's traffic and connection, then the data each app has used Shell: a terminal on the TV after getprop and pm list packages
What is using the CPU What is using the RAM What is using the network A shell on the TV

Rendered from the app's screenshot tests with sample data. The Install dialog is drawn to match the app.

What it does

Tellyscope talks to your Android TV, Google TV, NVIDIA Shield or Fire TV over Wi-Fi using ADB, the debugging protocol developers use. Tested on Fire TV (Fire OS 8); over HDMI its volume is fixed, so mute and volume are grayed out there. NVIDIA Shield hasn't been tested on real hardware yet.

A TV home screen after debloating: the inputs and the user's own apps, with no ads or suggestions

A TV after Tellyscope.

Languages

English, Español, 简体中文, 日本語, Русский and हिन्दी.

Safety rules

Debloating a TV can break it if done carelessly. Tellyscope keeps to these rules, and contributions must too:

  1. Disable, never uninstall, what came with the TV. Built-in apps get pm disable-user, which Undo or pm enable reverses. Uninstall is offered only for apps you installed (pm list packages -3), after a confirm. Tellyscope never runs pm uninstall --user 0.
  2. Record before changing. Before its first change on a TV, Tellyscope notes which apps were already off. Every change goes into that TV's History with an Undo (except uninstalls and Shell commands), and Restore everything turns back on only what Tellyscope turned off.
  3. Protected list. Apps the TV needs to boot, update, stay on Wi-Fi, show web pages, show its home screen or take input can't be stopped or disabled, with no override. A TV's list can only add warnings, never remove protection, and packages only one maker's TVs have are protected from tellyscope-devices' protected.json (see what the lists can't do). When you switch home screens, the old launcher is turned off only after Home is checked to open the new one.
  4. You see it first. Every change names the apps it touches and asks before it runs.
  5. No root, no exploits. Only what ADB allows on a stock TV.
  6. Nothing left on the TV. Two small helpers run from /data/local/tmp: one reads app names and icons and is deleted at once, the other runs the Remote and is deleted when the Remote closes.
  7. Private. No ads, tracking or accounts. The only internet requests fetch the shared lists, and in the GitHub build also check for a new version every 30 minutes, which you can turn off in Settings, and download Projectivy from its developer's GitHub releases when you ask for it. The Play Store build has no update check and downloads nothing from GitHub. Everything else stays on your Wi-Fi, except the DNS lookup of each TV's name during the scan.

The shared lists

Tellyscope downloads two sets of public lists from GitHub, so they can change without an app release. Both histories are public.

What the lists can't do:

Get it

You need a phone on Android 8.0 or newer, on the same Wi-Fi as the TV.

Setting up your TV

  1. On the TV, open About in Settings and press OK on Build (Fire TV: your device's name) 7 times.
  2. In Developer options, turn on USB debugging (Fire TV: ADB debugging), and Network debugging or Wireless debugging if your TV lists it.
  3. Open Tellyscope, pick your TV's brand under Add your TV, and tap Connect when your TV shows up. The app shows the exact menu names for your brand.
  4. On the TV, check the key matches the one Tellyscope shows, tick Always allow from this computer and press Allow. With wireless debugging, type the 6-digit pairing code instead.

From the community

Videos other people have made about Tellyscope.

Made a video or written a post about Tellyscope? Open an issue with the link and we'll add it here.

Building

Modules: :app (the phone app, Kotlin and Jetpack Compose), :adb (pure Kotlin ADB library on Kadb), app/src/helper (the on-TV label helper) and :cli (a desktop smoke test, not shipped). You need JDK 25 and the Android SDK with platform 37.

./gradlew build          # assemble, unit tests and lint
./gradlew :app:installGithubDebug

There are two builds of the same app, as Gradle flavors: github, the APK on GitHub releases, and play, the Play Store's. The update check and the Projectivy download live in app/src/github only, with stubs in app/src/play, and every Play build fails if its code names api.github.com. What differs on screen checks BuildConfig.PLAY. Unit tests run on the github build.

Contributing

See CONTRIBUTING.md. If you have an Android TV, a device report helps even if nothing worked.

Why the name?

In Wallace & Gromit's 2002 short The Tellyscope, Wallace builds a contraption so he can change the channel without leaving his armchair.

Star History

Star history chart for Tellyscope

License

GNU General Public License v3.0. Third-party credits are in NOTICE.

tellyscope (man15h/tellyscope)

正在搜索数据库…

这是什么?Tellyscope 是一款 Android 手机应用,通过 ADB 经 Wi-Fi 与你的 Android TV、Google TV、NVIDIA Shield 或 Fire TV 通信,让你可以精简预装应用、安装应用、传输文件和控制电视,全程无需 root,也无需电脑。
这东西会在我的电视上装东西吗,还是只在手机上运行?这是一个 3 MB 的应用,安装在你的手机上;它通过 ADB 远程控制电视。除了两个很小的电视端辅助脚本(用完即自动删除)之外,不会在电视上留下任何东西。
我该怎么把它连接到电视?在电视的设置中打开「关于」,连续点击「版本号」7 次以启用「开发者选项」,然后在其中开启「USB/网络调试」或「无线调试」;接着打开 Tellyscope,选择你电视的品牌并点击「连接」,最后在电视上确认调试密钥。
试用之前我需要准备什么?只需要一部运行 Android 8.0 或更高版本的手机,与电视连接同一个 Wi-Fi 网络,并且在电视上开启了调试功能的开发者选项即可——无需 root、无需漏洞利用,也无需电脑。
它真的能清除预装软件吗?在每个盒子上都能用吗?它只会禁用应用(pm disable-user),从不卸载电视自带的应用;受保护的核心系统应用列表中的应用,任何人都无法触碰。另外,Shield 和 Fire TV 的支持尚未在实际硬件上测试。
这个应用会追踪我,或把我的数据发送到别处吗?没有广告、没有追踪,也不需要账号;网络请求仅限于从 GitHub 获取精简列表以及定期检查更新(可以关闭),其余数据都留在你本地的 Wi-Fi 网络内。
它是如何决定禁用哪些应用的?它会根据你的电视型号,匹配 330 多份由社区测试、改编自 cleanyourtv 的精简列表;在执行任何操作之前,会先显示所有计划禁用的应用,你还可以取消勾选仍需使用的应用。
Tellyscope 能让我的电视拥有更好的主屏幕吗?在带有 Play 商店的电视上,它可以安装 Projectivy、AT4K、Dispatch 或 FLauncher 等启动器,并将其设为主屏幕;你也可以随时切换回原厂启动器。
它也能当遥控器用吗?可以——它提供方向键、主页/返回/菜单键、音量键、在电视上输入文字、可放置最多四个应用的快捷栏、重启功能,以及在 Android 13 或更低版本上的熄屏音乐模式。
Tellyscope 这个名字是从哪来的?它取名自《Wallace & Gromit》2002 年的短片 “The Tellyscope”,片中华莱士(Wallace)为了不离开扶手椅就能切换电视频道,造出了这台装置。
作者
man15h
大小
19.6 MB
星标
2.1K
时长
27天
提交 · 90 天