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 МБ, которое вы ставите на телефон. Оно управляет телевизором удалённо через ADB и ничего не оставляет на нём, кроме двух крошечных вспомогательных скриптов, которые удаляют себя сразу после использования.
Как подключить его к телевизору?Откройте «О телевизоре» в настройках ТВ и нажмите «Сборка» 7 раз, чтобы включить параметры разработчика. Затем включите там отладку по USB/сети или беспроводную отладку. После этого откройте Tellyscope, выберите марку телевизора и нажмите «Подключиться». Ключ отладки подтверждается на самом телевизоре.
Что нужно, прежде чем попробовать?Достаточно телефона с Android 8.0 или новее в той же Wi-Fi сети, что и телевизор, а также включённых на телевизоре параметров разработчика с отладкой. Ни root, ни эксплойты, ни компьютер не нужны.
Оно и правда удаляет ненужные приложения и работает на всех приставках?Оно только отключает приложения (pm disable-user) и никогда не удаляет то, что было установлено на телевизоре. Защищённый список базовых системных приложений нельзя затронуть ни при каких условиях. Поддержка Shield и Fire TV пока не проверялась на реальном оборудовании.
Отслеживает ли приложение меня или отправляет ли куда-то мои данные?Нет ни рекламы, ни трекинга, ни аккаунтов. Единственные сетевые запросы — загрузка списков для очистки с GitHub и периодическая проверка обновлений (её можно отключить). Всё остальное остаётся в вашей локальной Wi-Fi сети.
Как оно решает, какие приложения отключать?Оно сопоставляет модель вашего телевизора с более чем 330 проверенными сообществом списками для очистки, адаптированными из cleanyourtv. Перед тем как что-либо сделать, оно показывает все приложения, которые собирается отключить, и позволяет снять галочку с любого, которым вы всё ещё пользуетесь.
Может ли Tellyscope сделать главный экран телевизора удобнее?На телевизорах с Play Store оно может установить и назначить главным такие лаунчеры, как Projectivy, AT4K, Dispatch или FLauncher. В любой момент можно вернуть стандартный лаунчер.
Работает ли оно и как пульт?Да. Есть крестовина навигации, кнопки Home/Back/Menu, регулировка громкости, ввод текста на телевизоре, панель для закрепления до четырёх приложений, перезапуск и режим музыки с выключенным экраном на Android 13 и старше.
Откуда название Tellyscope?Название происходит от приспособления, которое Уоллес строит в короткометражке Wallace & Gromit 2002 года «The Tellyscope». С его помощью он переключает каналы телевизора, не вставая с кресла.
Автор
man15h
Размер
19.6 MB
Звёзды
2.1K
Возраст
27 д
Коммиты · 90 дней