# amitdaigavane-cell/fire-tv-studio architecture

> Architecture diagram of the GitHub repository amitdaigavane-cell/fire-tv-studio, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/amitdaigavane-cell/fire-tv-studio
- Repository: https://github.com/amitdaigavane-cell/fire-tv-studio

## Overview

TV Home Studio combines a Fire TV launcher with an Android phone companion for installation, customization, and device care. The TV workflow is remote input → Home rendering and app launch, backed by theme configuration, wallpapers, weather, and Home lifecycle handling. The companion manages TV operations over authenticated ADB; README-described capabilities such as cleanup, update restrictions, and restore points are represented even where their implementation was not sampled. Edges rely on excerpts, SOURCE INDEX references, or README statements; unsampled details are not inferred.

Main entry points: [`launcher/app/src/main/java/com/gathin/tvhome/HomeSurface.java`](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/HomeSurface.java) (Home Surface), [`launcher/companion/src/main/java/com/veyra/tvmanager/TvController.java`](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/companion/src/main/java/com/veyra/tvmanager/TvController.java) (TV Controller), [`launcher/app/src/main/java/com/gathin/tvhome/WeatherInfo.java`](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/WeatherInfo.java) (Weather Display), [`launcher/app/src/main/java/com/gathin/tvhome/StudioConfig.java`](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/StudioConfig.java) (Theme Configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_tv["TV Home"]
  node_home["Home Surface<br/>[HomeSurface.java]"]
  node_cinema["Cinema Dock<br/>[CinemaDock.java]"]
  node_apps["App Catalog"]
  node_apporder["App Ordering<br/>[AppOrder.java]"]
  node_recent["Recent Apps<br/>[RecentApps.java]"]
  node_inputs["TV Inputs<br/>[TvInputs.java]"]
end

subgraph group_settings["Themes and Status"]
  node_config[("Theme Configuration<br/>[StudioConfig.java]")]
  node_wallpaperstore["Wallpaper Storage"]
  node_wallpaper["Wallpaper Rendering<br/>[HomeWallpaper.java]"]
  node_weather["Weather Display<br/>[WeatherInfo.java]"]
  node_provider["Studio Provider"]
end

subgraph group_lifecycle["Home Lifecycle"]
  node_idle["Idle Screensaver<br/>[HomeIdle.java]"]
  node_redirect["Home Routing"]
  node_boot["Boot Recovery<br/>[BootReceiver.java]"]
  node_power["Power Actions<br/>[PowerActions.java]"]
end

subgraph group_phone["Phone Companion"]
  node_phoneui["Companion App<br/>[MainActivity.java]"]
  node_controller["TV Controller<br/>[TvController.java]"]
  node_adb["ADB Client<br/>[AdbClient.java]"]
  node_crypto["ADB Credentials<br/>[AdbCrypto.java]"]
end

subgraph group_shared["Shared Services"]
  node_weatherapi["Weather Requests<br/>[WeatherApi.java]"]
  node_cleanup["Cleanup Catalog"]
end

node_remote(("TV Remote User"))
node_weatherhost{{"Open-Meteo"}}
node_phone(("Phone User"))
node_firetv{{"Fire TV"}}

node_remote -->|"navigates"| node_home
node_home -->|"loads apps"| node_apps
node_home -->|"orders apps"| node_apporder
node_home -->|"renders dock"| node_cinema
node_home -->|"uses recents"| node_recent
node_home -->|"reads settings"| node_config
node_home -->|"renders wallpaper"| node_wallpaper
node_home -->|"binds weather"| node_weather
node_home -->|"shows inputs"| node_inputs
node_home -->|"manages idle"| node_idle
node_cinema -->|"uses wallpaper"| node_wallpaper
node_wallpaper -->|"reads theme"| node_config
node_weather -->|"reads settings"| node_config
node_weather -->|"fetches forecast"| node_weatherapi
node_weatherapi -->|"requests data"| node_weatherhost
node_idle -->|"binds weather"| node_weather
node_boot -->|"starts recovery"| node_redirect
node_redirect -->|"shows Home"| node_home
node_redirect -->|"dispatches actions"| node_power
node_config -->|"manages images"| node_wallpaperstore
node_phone -->|"customizes"| node_phoneui
node_phoneui -->|"invokes controls"| node_controller
node_controller -->|"runs commands"| node_adb
node_adb -->|"authenticates with"| node_crypto
node_controller -->|"uses catalog"| node_cleanup
node_controller -->|"manages device"| node_firetv
node_phoneui -.->|"customizes themes"| node_provider
node_controller -->|"installs and repairs"| node_firetv

click node_home "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/HomeSurface.java"
click node_cinema "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/CinemaDock.java"
click node_apps "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/LaunchableApps.java"
click node_apporder "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/AppOrder.java"
click node_recent "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/RecentApps.java"
click node_config "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/StudioConfig.java"
click node_wallpaperstore "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/WallpaperStore.java"
click node_wallpaper "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/HomeWallpaper.java"
click node_weather "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/WeatherInfo.java"
click node_weatherapi "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/common/src/main/java/com/veyra/shared/WeatherApi.java"
click node_idle "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/HomeIdle.java"
click node_redirect "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/HomeRedirectService.java"
click node_boot "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/BootReceiver.java"
click node_power "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/PowerActions.java"
click node_inputs "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/TvInputs.java"
click node_provider "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/StudioProvider.java"
click node_phoneui "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/companion/src/main/java/com/veyra/tvmanager/MainActivity.java"
click node_controller "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/companion/src/main/java/com/veyra/tvmanager/TvController.java"
click node_adb "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/companion/src/main/java/com/veyra/tvmanager/AdbClient.java"
click node_crypto "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/companion/src/main/java/com/cgutman/adblib/AdbCrypto.java"
click node_cleanup "https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/common/src/main/java/com/veyra/shared/CleanupCatalog.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_cinema,node_apps,node_apporder,node_recent,node_inputs,node_remote,node_phone toneBlue
class node_config,node_wallpaperstore,node_wallpaper,node_weather,node_provider toneAmber
class node_idle,node_redirect,node_boot,node_power toneMint
class node_phoneui,node_controller,node_adb,node_crypto toneRose
class node_weatherapi,node_cleanup,node_weatherhost,node_firetv toneIndigo
```

## Components

### TV Home

- [Home Surface](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/HomeSurface.java): `launcher/app/src/main/java/com/gathin/tvhome/HomeSurface.java`
- [Cinema Dock](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/CinemaDock.java): `launcher/app/src/main/java/com/gathin/tvhome/CinemaDock.java`
- [App Catalog](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/LaunchableApps.java): `launcher/app/src/main/java/com/gathin/tvhome/LaunchableApps.java`
- [App Ordering](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/AppOrder.java): `launcher/app/src/main/java/com/gathin/tvhome/AppOrder.java`
- [Recent Apps](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/RecentApps.java): `launcher/app/src/main/java/com/gathin/tvhome/RecentApps.java`
- [TV Inputs](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/TvInputs.java): `launcher/app/src/main/java/com/gathin/tvhome/TvInputs.java`

### Themes and Status

- [Theme Configuration](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/StudioConfig.java): `launcher/app/src/main/java/com/gathin/tvhome/StudioConfig.java`
- [Wallpaper Storage](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/WallpaperStore.java): `launcher/app/src/main/java/com/gathin/tvhome/WallpaperStore.java`
- [Wallpaper Rendering](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/HomeWallpaper.java): `launcher/app/src/main/java/com/gathin/tvhome/HomeWallpaper.java`
- [Weather Display](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/WeatherInfo.java): `launcher/app/src/main/java/com/gathin/tvhome/WeatherInfo.java`
- [Studio Provider](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/StudioProvider.java): `launcher/app/src/main/java/com/gathin/tvhome/StudioProvider.java`

### Home Lifecycle

- [Idle Screensaver](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/HomeIdle.java): `launcher/app/src/main/java/com/gathin/tvhome/HomeIdle.java`
- [Home Routing](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/HomeRedirectService.java): `launcher/app/src/main/java/com/gathin/tvhome/HomeRedirectService.java`
- [Boot Recovery](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/BootReceiver.java): `launcher/app/src/main/java/com/gathin/tvhome/BootReceiver.java`
- [Power Actions](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/app/src/main/java/com/gathin/tvhome/PowerActions.java): `launcher/app/src/main/java/com/gathin/tvhome/PowerActions.java`

### Phone Companion

- [Companion App](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/companion/src/main/java/com/veyra/tvmanager/MainActivity.java): `launcher/companion/src/main/java/com/veyra/tvmanager/MainActivity.java`
- [TV Controller](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/companion/src/main/java/com/veyra/tvmanager/TvController.java): `launcher/companion/src/main/java/com/veyra/tvmanager/TvController.java`
- [ADB Client](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/companion/src/main/java/com/veyra/tvmanager/AdbClient.java): `launcher/companion/src/main/java/com/veyra/tvmanager/AdbClient.java`
- [ADB Credentials](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/companion/src/main/java/com/cgutman/adblib/AdbCrypto.java): `launcher/companion/src/main/java/com/cgutman/adblib/AdbCrypto.java`

### Shared Services

- [Weather Requests](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/common/src/main/java/com/veyra/shared/WeatherApi.java): `launcher/common/src/main/java/com/veyra/shared/WeatherApi.java`
- [Cleanup Catalog](https://github.com/amitdaigavane-cell/fire-tv-studio/blob/main/launcher/common/src/main/java/com/veyra/shared/CleanupCatalog.java): `launcher/common/src/main/java/com/veyra/shared/CleanupCatalog.java`

### Other components

- **TV Remote User**
- **Open-Meteo**
- **Phone User**
- **Fire TV**

## Connections

- TV Remote User → Home Surface: navigates (evidence: `README.md`)
- Home Surface → App Catalog: loads apps (evidence: `launcher/app/src/main/java/com/gathin/tvhome/HomeSurface.java`)
- Home Surface → App Ordering: orders apps (evidence: `launcher/app/src/main/java/com/gathin/tvhome/HomeSurface.java`)
- Home Surface → Cinema Dock: renders dock (evidence: `launcher/app/src/main/java/com/gathin/tvhome/HomeSurface.java`)
- Home Surface → Recent Apps: uses recents (evidence: `launcher/app/src/main/java/com/gathin/tvhome/HomeSurface.java`)
- Home Surface → Theme Configuration: reads settings (evidence: `launcher/app/src/main/java/com/gathin/tvhome/HomeSurface.java`)
- Home Surface → Wallpaper Rendering: renders wallpaper (evidence: `launcher/app/src/main/java/com/gathin/tvhome/HomeSurface.java`)
- Home Surface → Weather Display: binds weather (evidence: `launcher/app/src/main/java/com/gathin/tvhome/HomeSurface.java`)
- Home Surface → TV Inputs: shows inputs (evidence: `launcher/app/src/main/java/com/gathin/tvhome/HomeSurface.java`)
- Home Surface → Idle Screensaver: manages idle (evidence: `launcher/app/src/main/java/com/gathin/tvhome/HomeSurface.java`)
- Cinema Dock → Wallpaper Rendering: uses wallpaper (evidence: `launcher/app/src/main/java/com/gathin/tvhome/CinemaDock.java`)
- Wallpaper Rendering → Theme Configuration: reads theme (evidence: `launcher/app/src/main/java/com/gathin/tvhome/HomeWallpaper.java`)
- Weather Display → Theme Configuration: reads settings (evidence: `launcher/app/src/main/java/com/gathin/tvhome/WeatherInfo.java`)
- Weather Display → Weather Requests: fetches forecast (evidence: `launcher/app/src/main/java/com/gathin/tvhome/WeatherInfo.java`)
- Weather Requests → Open-Meteo: requests data (evidence: `launcher/common/src/main/java/com/veyra/shared/WeatherApi.java`)
- Idle Screensaver → Weather Display: binds weather (evidence: `launcher/app/src/main/java/com/gathin/tvhome/HomeIdle.java`)
- Boot Recovery → Home Routing: starts recovery (evidence: `launcher/app/src/main/java/com/gathin/tvhome/BootReceiver.java`)
- Home Routing → Home Surface: shows Home (evidence: `launcher/app/src/main/java/com/gathin/tvhome/HomeRedirectService.java`)
- Home Routing → Power Actions: dispatches actions (evidence: `launcher/app/src/main/java/com/gathin/tvhome/HomeRedirectService.java`)
- Theme Configuration → Wallpaper Storage: manages images (evidence: `launcher/app/src/main/java/com/gathin/tvhome/StudioConfig.java`)
- Phone User → Companion App: customizes (evidence: `README.md`)
- Companion App → TV Controller: invokes controls (evidence: `launcher/companion/src/main/java/com/veyra/tvmanager/MainActivity.java`)
- TV Controller → ADB Client: runs commands (evidence: `launcher/companion/src/main/java/com/veyra/tvmanager/TvController.java`)
- ADB Client → ADB Credentials: authenticates with (evidence: `launcher/companion/src/main/java/com/veyra/tvmanager/AdbClient.java`)
- TV Controller → Cleanup Catalog: uses catalog (evidence: `launcher/companion/src/main/java/com/veyra/tvmanager/TvController.java`)
- TV Controller → Fire TV: manages device (evidence: `README.md`)
- Companion App → Studio Provider: customizes themes (evidence: `README.md`)
- TV Controller → Fire TV: installs and repairs (evidence: `README.md`)
