Skip to content

Debloat any Android or Google TV over Wi-Fi and get an Apple TV-style home.

Docs: add Xiaomi MiTV-AXFR1 device note and link from tv.json

Sayon Sur08fd2327fdf7
diff --git a/docs/devices/xiaomi-mitv-axfr1.md b/docs/devices/xiaomi-mitv-axfr1.md
new file mode 100644
index 000000000..c9a85f176
--- /dev/null
+++ b/docs/devices/xiaomi-mitv-axfr1.md
@@ -0,0 +1,77 @@
+# Xiaomi MiTV-AXFR1 (rango, dune): Android TV 11 Setup & HDMI ARC Audio
+
+Tested on **Xiaomi MiTV-AXFR1** (codename `rango`, product `dune`, Amlogic/droidlogic, 1 GB RAM, India), running **Android TV 11** (SDK 30, build `RTT0.210630.002.485`).
+
+---
+
+## 1. Hardware & System Details
+
+| Property | Value |
+|---|---|
+| Model | `MiTV-AXFR1` |
+| Codename / Product | `rango` / `dune` |
+| Chipset | Amlogic / droidlogic |
+| Android / API | 11 / 30 |
+| Firmware Build | `RTT0.210630.002.485` |
+| External Audio | JBL Cinema SB510 over HDMI ARC (Port 1) |
+| Live TV App | `com.android.tv` |
+| Stock Launcher | `com.google.android.tvlauncher` |
+
+---
+
+## 2. Tested Debloat List
+
+The debloat list in [`examples/xiaomi-mitv-axfr1/debloat.txt`](../../examples/xiaomi-mitv-axfr1/debloat.txt) safely disables 16 packages across 4 categories:
+
+1. **Xiaomi & Google Telemetry**:
+ - `com.miui.tv.analytics`
+ - `com.xiaomi.statistic`
+ - `com.google.android.feedback`
+2. **PatchWall, Content & Sponsored Rows**:
+ - `com.mitv.tvhome.atv` (PatchWall)
+ - `com.xm.webcontent`
+ - `com.google.android.tvrecommendations`
+ - `android.autoinstalls.config.xioami.dangal`
+ - `com.mitv.tvhome.mitvplus`
+3. **Xiaomi Background Services**:
+ - `com.xiaomi.mitv.tvmanager` (Cleaner)
+ - `com.xiaomi.mitv.handbook`
+ - `com.xiaomo.tv.milegal`
+4. **Preloaded Media**:
+ - `com.xiaomi.mimusic2`
+ - `com.google.android.play.games`
+ - `com.google.android.videos`
+ - `com.mitv.dream`
+
+### Critical Safety Notes:
+- Keep `com.droidlogic.tvinput`, `com.android.tv`, and Bluetooth/remote services enabled.
+- Settings and Inputs menu (`com.android.tv.selectinput.SelectInputActivity`) remain fully functional.
+- Changes survive reboots and are applied via `pm disable-user --user 0`, never uninstalled.
+
+---
+
+## 3. Launcher Configuration (`com.gathin.tvhome`)
+
+- **Sideloading & Custom Home**: Android TV 11 on this set accepts third-party `CATEGORY_HOME` packages without requiring a manufacturer signature.
+- **Icon-Only Top Bar**:
+ Setting `icon_only_buttons` and `icon_only_inputs` to `true` renders Inputs, Wi-Fi, Reorder, and Settings as clean 42dp circular buttons with text labels omitted.
+- **Interactive App Reordering**:
+ Enabled with `<bool name="reorder_button">true</bool>` and `<bool name="tile_menu">true</bool>`. Users can move app tiles using the top-bar reorder icon or by holding the OK button on any tile.
+
+---
+
+## 4. HDMI ARC Audio & Floating Volume Overlay
+
+### The HDMI ARC Volume Problem
+When an external soundbar (e.g. JBL Cinema SB510) is active on HDMI ARC (`mArcEstablished: true`, `mSystemAudioActivated: true`), Android's `AudioService` suppresses the native TV volume UI dialog (`flags: 0x0`) to prevent duplicate on-screen indicators.
+
+### The Solution: Accessibility Volume Overlay
+- An accessibility overlay window (`TYPE_ACCESSIBILITY_OVERLAY`) hooked into `HomeKeyService`.
+- Listens to both `onKeyEvent` (for immediate hardware remote response) and `android.media.VOLUME_CHANGED_ACTION`.
+- Renders a vertical frosted-glass pill on the right side of the screen (`Gravity.CENTER_VERTICAL | Gravity.END`):
+ - `πŸ”Š` `VOL` `+` (Volume Up)
+ - `πŸ”‰` `VOL` `βˆ’` (Volume Down)
+ - `πŸ”‡` `MUTE` `βœ•` (Mute)
+- Directional indicator avoids the de-synchronization issue where Android's software stream caps at 100 while the soundbar amplifier can still step up.
+- Does not consume the key event, allowing CEC commands (`<User Control Pressed 44>`) to pass uninterrupted to the soundbar.
+- Full fork implementation available in [sayonsur/cleanyourtv (feature/mitv-axfr1-arc-volume)](https://github.com/sayonsur/cleanyourtv/tree/feature/mitv-axfr1-arc-volume).
diff --git a/examples/README.md b/examples/README.md
index f04e4bbf4..070390661 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -345,7 +345,7 @@ on that firmware, grouped and commented. These are starting points: comment out
| `xiaomi-mitv-astp0/` | Xiaomi MiTV-ASTP0 (mulan, sold as L55M7-EA), China firmware 22.12.2.1630, 1.5 GB RAM | Android TV 9 (CN build) | Sibling of ASTP1: Mi analytics/push/cloud control, shop plugin, TV Manager, the Chinese wake word (~30% CPU) and the phone-remote relay that loops at 100-190% CPU off; casting except AirPlay, payment, voice and Mi Video off by choice; keep `com.mitv.tvhome` (Home falls to FallbackHome without it); inputs switch only with Xiaomi's `EXTSRC_PLAY`; time zone ships as Asia/Shanghai |
| `xiaomi-mitv-astp1/` | Xiaomi MiTV-ASTP1 (maverick), China firmware 2.40.641.0514.cn, 1 GB RAM, 720p | Android TV 9 (CN build) | First CN-firmware Xiaomi: no Google apps; stock launcher `com.mitv.tvhome` (pass `STOCK_LAUNCHER`); ADB closes on every reboot; Mi analytics/push/ads, shop plugin, TV Manager, updater off; casting and app store kept |
| `xiaomi-mitv-axfr0/` | Xiaomi MiTV-AXFR0 (rango, Amlogic, 1 GB), India | Android TV 11 | PatchWall, Mi analytics, sponsored rows, partner auto-installs, TV Manager; screen mirroring and preloaded streaming apps off by choice; Chromecast and voice kept; custom HOME accepted, setupwraith does not claim HOME |
-| `xiaomi-mitv-axfr1/` | Xiaomi MiTV-AXFR1 (rango, Amlogic, 1 GB), India | Android TV 11 | PatchWall, Mi analytics, sponsored rows, partner auto-installs, TV Manager; mirroring, OTA and unused streaming apps off by choice; Chromecast and voice kept; PatchWall's input popup is unused (input picker is Live TV's); custom HOME accepted, setupwraith does not claim HOME |
+| `xiaomi-mitv-axfr1/` | Xiaomi MiTV-AXFR1 (rango, Amlogic, 1 GB), India | Android TV 11 | PatchWall, Mi analytics, sponsored rows, partner auto-installs, TV Manager; mirroring, OTA and unused streaming apps off by choice; Chromecast and voice kept; PatchWall's input popup is unused (input picker is Live TV's); custom HOME accepted, setupwraith does not claim HOME ([device note](../docs/devices/xiaomi-mitv-axfr1.md)) |
| `xiaomi-mitv-axso0/` | Xiaomi MiTV-AXSO0 (dangal; Mi TV 4C Pro 2019 / 4A Pro) | Android TV 9 | PatchWall, Glance ads, Mi TV+, Sensara, Mi analytics, MiLink; voice, Chromecast, unused streaming apps off by choice |
| `xiaomi-mitv-axso2/` | Xiaomi MiTV-AXSO2 (dangalUHD, India, 2 GB) | Android TV 9 | PatchWall, Mi TV+, Sensara, Mi analytics, TV Manager, updater, partner auto-installs, old partner app copies; voice, all casting and streaming apps kept; sign-in notice and storage notes |
| `xiaomi-mitv-mftr0/` | Xiaomi MiTV-MFTR0 (freeguy, MediaTek mt9653), China firmware OS2.0.23.0.RFTMATV (HyperOS TV 2) | Android 11 (HyperOS TV 2, CN build) | Second CN set from the ASTR0 sessions, one HyperOS generation earlier (Android 11): same ad screensaver carrier (`com.xiaomi.mitv.hyper.screensaver`) and the same `com.ts.launcher` allowlist trampoline for third-party Home with PatchWall disabled, both carried over and verified; no WPS/overseaservice/adservices here; keep `com.xiaomi.mitv.smartpanel` (Menu-button panel); ADB needs the on-TV RSA confirmation once and closes on every reboot; [debloat and Home notes](../docs/devices/xiaomi-mitv-mftr0-debloat-home.md), [inputs/settings notes](../docs/devices/xiaomi-mitv-mftr0-freeguy.txt) |
diff --git a/examples/xiaomi-mitv-axfr1/tv.json b/examples/xiaomi-mitv-axfr1/tv.json
index f16dbc159..e8e3517f8 100644
--- a/examples/xiaomi-mitv-axfr1/tv.json
+++ b/examples/xiaomi-mitv-axfr1/tv.json
@@ -2,5 +2,5 @@
"tv": "Xiaomi MiTV-AXFR1 (rango, Amlogic, 1 GB), India",
"os": "Android TV 11",
"brand": "Xiaomi",
- "notes": "PatchWall, Mi analytics, sponsored rows, partner auto-installs, TV Manager; mirroring, OTA and unused streaming apps off by choice; Chromecast and voice kept; PatchWall's input popup is unused (input picker is Live TV's); custom HOME accepted, setupwraith does not claim HOME"
+ "notes": "PatchWall, Mi analytics, sponsored rows, partner auto-installs, TV Manager; mirroring, OTA and unused streaming apps off by choice; Chromecast and voice kept; PatchWall's input popup is unused (input picker is Live TV's); custom HOME accepted, setupwraith does not claim HOME ([device note](../docs/devices/xiaomi-mitv-axfr1.md))"
}