Skip to content
Techyeye98Public

About

Clean up and personalise your Android TV from your phone. Manage apps, customise your home screen, add wallpapers, and restore changes.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

11 stars

Watchers

0 watching

Forks

Latest commit

 

History

18 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TVora icon

TVora

Your TV. Your way.
Clean up and personalise your Android TV from your phone.

Download TVora APK for Android

Download latest APK · Release notes
Free · Android 9+ phone · No account or subscription needed

New to GitHub? Tap Download TVora APK above to open the latest release. Under Assets, tap the file ending in .apk (expand Assets if needed). Open the downloaded APK on your Android phone and, if Android asks, allow installation from your browser or file manager. Install TVora, then connect your phone and TV to the same Wi-Fi. You do not need a GitHub account.

Used on the maintainer's Mi TV, with positive feedback from users on their setups. See the setup instructions below to get started.

TVora helps you choose the apps you see, arrange your Home screen, add your own wallpaper and reduce TV clutter with a recovery path. No ChatGPT account, coding agent or subscription is needed to run the app. TV permissions and debugging authorization are always granted by the owner.

Make it yours

  • Home screen: select apps and arrange the dock and the rows below it.
  • Show or hide apps: change Home visibility without uninstalling an app. Showing an app again restores its saved place, unless you changed its saved order in between.
  • Your wallpaper: choose a photo from your phone. TVora makes a bounded, metadata-stripped JPEG copy, with camera orientation handled, and sends it only to your selected TV.
  • Quick buttons: Inputs, Wi-Fi, Bluetooth headphones and remote app arrangement; Settings remains accessible.
  • Arrange from the TV: open the arrows button beside Settings. OK picks up an app, arrows move it, Back places it, and Back again saves and finishes. Extra app rows scroll below the dock; adding or moving apps preserves the chosen theme's title and spacing below the clock.
  • Cleanup with recovery: review the plan, save a restore point, disable supported packages and put them back individually or restore the supported previous setup.
  • Connect from the phone: legacy network ADB and pairing-code/TLS support.
  • Interface: preserves the upstream Outfit typography, glass surfaces, ambient glow, animated TV illustration and interaction motion. TVora's extra controls use the same list rows and sheets. TVora's text-free icon is a closed glass TV with two feet and a soft glow.

The bundled TV launcher retains the original black background and app-colour glow by default. Changing the phone app's appearance does not change a TV until its owner applies a setting.

Screens

TVora welcome screen TVora TV dashboard TVora Home screen

Screenshots in docs/screenshots are captured from the actual Compose UI with Robolectric, not marketing mockups. Appearance can vary with your phone and TV.

Try it

Use an Android 9+ phone and a supported Android/Google TV on the same trusted Wi-Fi network. Enable TV debugging, select the TV and approve the phone on the TV. For modern Wireless debugging, use the TV's six-digit pairing code, pairing port and its separate connection port.

Review the plan before Make it clean. Use Home screen for appearance and app placement. For an existing TV, after updating TVora open Home screen → Quick buttons, leave Arrange apps on TV on and tap Done. This sends the new button and reapplies the theme's dock spacing. More apps remain below the dock and are reached with Down on the remote. Save a copy of the recovery scripts outside the app. Finish closes debugging unless you chose to keep it on; enable it again for a later management session.

Some TVs support cleanup only and keep their own launcher. Manufacturer, firmware and Android version determine the available features. Samsung Tizen and LG webOS are not supported.

Build

JDK 21, Android SDK platform 37 and build tools 36 are required. The modified launcher source is vendored under third_party/cleanyourtv; this checkout needs no private upstream signing key and no Git submodule initialization to build the phone app.

./gradlew :core:ops:test :core:flows:test :adb:pairing:test checkModuleGraph
./gradlew :app:assembleFullDebug :app:lintFullDebug

Debug APK: app/build/outputs/apk/full/debug/app-full-debug.apk. Application ID: dev.tvora.app. Code namespaces remain tv.cleanyour.* for maintainable upstream integration; the installed app identity and public branding are TVora.

Published APKs are signed with TVora's existing signing identity so updates preserve app data. assembleFullRelease is unsigned unless local signing is configured; see release signing. The app checks TVora's GitHub releases and opens the release page when an update is available.

Cards and modules are disabled. The Play flavour uses store-managed updates; neither flavour turns off TV software updaters. Settings includes GitHub support and Telegram contact. Made by Namya Mehta.

Testing and compatibility

See Restore verification for recovery coverage and limits.

TVora has been used on the maintainer's Mi TV, and users have reported successful use on their setups. Automated checks cover core operations, state machines and recovery scenarios.

Tested on two TVs, with working use confirmed by the owner. The owner has also tested TVora 0.1.1 and confirmed that restore now opens the original Home automatically.

On MiTV-AXSO0 (Android 9), the cleanup, restore and reboot cycle was checked against the original backup: all 112 original packages matched their baseline states, and Google Home returned. Automated regression tests cover the final Home handoff as well as the recovery flow.

Focused TVora screenshots cover onboarding, dashboard, Home screen and large text. Older upstream goldens remain as reference; they are not a visual baseline for the redesign. Record current baselines on Linux before enabling a full screenshot-verification gate.

The universal release includes multiple ABIs for Conscrypt and native SPAKE2 and exceeds the base project's 8 MB size budget. The inherited size-check task remains available; the preview workflow does not claim that budget passes. Per-ABI distribution is a possible later optimization.

Profiles, account/cloud sync, setup sharing, character artwork and a general APK uploader are outside this preview. Recovery is for supported settings and package states, not firmware, app data or streaming-account backups. Imported photos are not included in recovery-script exports.

Credits and license

TVora is an independent derivative of Clean Your TV app by udhaykumarbala, based on revision a8e55aa. Its launcher, themes and community TV lists come from Clean Your TV by Gathin and contributors, pinned at 3e34f40f42728284bbb3d4d7bea57c3f504c3b31, with TVora's Bluetooth shortcut changes. Those projects and their owners are credited; TVora does not imply their endorsement.

The app and launcher are MIT licensed; original notices are retained. Native SPAKE2 is LGPL-3.0, Conscrypt and the adapted pairing cipher are Apache-2.0. See THIRD-PARTY-NOTICES, LICENSE, and third_party_sources for corresponding pairing-library source archives.

See PRIVACY.md for local data handling and TV-STUDIO.md for the initial implementation record. Download the current APK from TVora releases.

About

Clean up and personalise your Android TV from your phone. Manage apps, customise your home screen, add wallpapers, and restore changes.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

11 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages