ToomRamcharan / tv-vibehack

# tv-vibehack 📺✨
> **Transform any ad-bloated Android TV or Google TV into a lightning-fast, tvOS-inspired, fail-safe experience — without root, without bootloop risks, and without losing access to stock features.**
 -green.svg)
---
## 📐 Architecture & Transformation Overview
 [code] 
---
## 🎯 The Motivation
Modern Smart TVs ship with:
- **Sponsored ads covering 70% of the screen**.
- **Sluggish bloatware** and 50+ pre-installed background apps consuming memory and tracking habits.
- **Unremappable sponsored remote buttons** (Netflix, Prime Video) that elderly family members hit by mistake, throwing them into subscription walls.
- **Overly complicated navigation** that makes switching to Cable/HDMI or playing personal home videos a headache.
**tv-vibehack** solves this permanently. Originally built to give aging parents a distraction-free, one-touch TV experience, it provides a universal blueprint for taking back control of any Android TV without root.
---
## ⚡ What Makes This Different?
### 1. 🛡️ The 100% Fail-Safe Architecture (Zero Bootloops)
On Android 14 Google TV, disabling the stock launcher (`com.google.android.apps.tv.launcherx`) breaks Direct Boot, tripping Android's `RescueParty` service and bricking the TV into a black-screen recovery state.
**tv-vibehack never disables `launcherx`.** Instead:
- The custom launcher is **`directBootAware="true"`**.
- A lightweight native **Accessibility Service** (`HomeKeyService`) intercepts Home key events and window transitions in under 10ms.
- If the custom launcher is ever uninstalled or crashes, Google TV seamlessly takes over. **Zero chance of bricking your TV.**
### 2. 🔀 Hardware Passthrough (Direct HDMI Switching)
No more opening 4 nested TV menus just to watch cable. Through reverse-engineered Realtek RTD `TvContract` passthrough URIs, the launcher switches directly to HDMI inputs programmatically:
 [code] 
### 3. 🎮 Sponsored Remote Key Remapping (No Root)
`HomeKeyService` intercepts hardcoded hardware remote buttons (`KEYCODE_BUTTON_3` for Netflix, `KEYCODE_BUTTON_4` for Prime Video, `KEYCODE_PROG_RED`/`GREEN`) and redirects them straight to HDMI 2 / Set-Top Box in :5555
 [code] bash
# Example for Acer / Realtek QLED Android 14 TVs
adb shell pm disable-user --user 0 com.google.android.tvrecommendations
 [code] bash
cd launcher
./gradlew assembleDebug
adb install -r app/build/outputs/apk/debug/app-debug.apk
 [code] bash
adb shell settings put secure enabled_accessibility_services com.gathin.tvhome/.HomeKeyService
adb shell settings put secure accessibility_enabled 1
```
---
## 📁 Repository Structure
| Path | Description |
|---|---|
| `launcher/` | Native Android TV launcher with Apple tvOS aesthetics, D-pad navigation, ambient glow, and Direct Boot awareness. |
| `launcher/.../HomeKeyService.java` | Fail-safe Accessibility Service intercepting Home button and sponsored hotkeys. |
| `launcher/.../HdmiHelper.java` | Direct Realtek / Android TV hardware passthrough input launcher. |
| `launcher/