# sabrizlt/irbas-tv architecture

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

- Interactive diagram: https://gitdiagram.com/sabrizlt/irbas-tv
- Repository: https://github.com/sabrizlt/irbas-tv

## Overview

Irbas TV is an Android TV launcher with a phone-based web remote, voice assistant, and optional Irbas server connection. The main path is viewer → home screen → installed-app launch; setup, Home-key enforcement, QR pairing, remote commands, and voice queries are distinct capabilities. Source excerpts show the key launch and request paths; README documents the local-network remote and optional server privacy boundary. Unsampled modules are included only where the README or source index establishes their role, with uncertain links omitted.

Main entry points: [`app/src/main/java/it/irbas/tv/HomeActivity.java`](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/HomeActivity.java) (Home screen), [`app/src/main/java/it/irbas/tv/AssistActivity.java`](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/AssistActivity.java) (Voice assistant), [`app/src/main/java/it/irbas/tv/RemoteServer.java`](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/RemoteServer.java) (Remote HTTP server), [`app/src/main/java/it/irbas/tv/PairActivity.java`](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/PairActivity.java) (Pairing screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_launcher["TV Launcher"]
  node_home["Home screen<br/>[HomeActivity.java]"]
  node_apps["App catalog<br/>[Apps.java]"]
  node_app_grid["All apps<br/>[AppsActivity.java]"]
  node_home_guard["Home-key guard"]
  node_backdrop["Animated backdrop<br/>[BackdropView.java]"]
  node_usage["App usage<br/>[Usage.java]"]
end

subgraph group_setup["Setup &amp; Pairing"]
  node_setup_flow["Setup guide<br/>[SetupActivity.java]"]
  node_pair_screen["Pairing screen<br/>[PairActivity.java]"]
  node_pairing["Pairing data<br/>[Pairing.java]"]
end

subgraph group_remote["Phone Remote"]
  node_remote_page["Remote web page<br/>[remote.html]"]
  node_remote_service["Remote service<br/>[RemoteService.java]"]
  node_remote_server["Remote HTTP server<br/>[RemoteServer.java]"]
  node_adb["Local ADB<br/>[LocalAdb.java]"]
end

subgraph group_assistant["Voice Assistant"]
  node_assistant_ui["Voice assistant"]
  node_orb["Assistant orb<br/>[OrbView.java]"]
  node_voice_wave["Voice animation<br/>[VoiceWave.java]"]
end

subgraph group_integration["Irbas Integration"]
  node_irbas_link["Server client<br/>[IrbasLink.java]"]
end

node_viewer(("TV viewer"))
node_phone(("Phone user"))
node_irbas_server(("Irbas server"))

node_viewer -->|"opens"| node_home
node_home -->|"lists apps"| node_apps
node_home -->|"renders"| node_backdrop
node_home -->|"reads usage"| node_usage
node_home -->|"opens"| node_app_grid
node_home_guard -->|"redirects home"| node_home
node_home -->|"starts"| node_remote_service
node_remote_service -->|"starts"| node_remote_server
node_phone -->|"uses"| node_remote_page
node_remote_page -->|"sends commands"| node_remote_server
node_remote_server -->|"queries catalog"| node_apps
node_remote_server -->|"dispatches keys"| node_home_guard
node_remote_server -->|"runs commands"| node_adb
node_home -->|"opens pairing"| node_pair_screen
node_pair_screen -->|"gets QR data"| node_pairing
node_setup_flow -->|"renders card"| node_pair_screen
node_home -->|"opens"| node_assistant_ui
node_assistant_ui -->|"opens app"| node_apps
node_assistant_ui -->|"renders"| node_orb
node_assistant_ui -->|"renders"| node_voice_wave
node_assistant_ui -->|"sends question"| node_irbas_link
node_irbas_link -->|"HTTP requests"| node_irbas_server

click node_home "https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/HomeActivity.java"
click node_apps "https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/Apps.java"
click node_app_grid "https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/AppsActivity.java"
click node_home_guard "https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/HomeKeyService.java"
click node_backdrop "https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/BackdropView.java"
click node_usage "https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/Usage.java"
click node_setup_flow "https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/SetupActivity.java"
click node_pair_screen "https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/PairActivity.java"
click node_pairing "https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/Pairing.java"
click node_remote_page "https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/assets/remote.html"
click node_remote_service "https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/RemoteService.java"
click node_remote_server "https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/RemoteServer.java"
click node_adb "https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/LocalAdb.java"
click node_assistant_ui "https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/AssistActivity.java"
click node_orb "https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/OrbView.java"
click node_voice_wave "https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/VoiceWave.java"
click node_irbas_link "https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/IrbasLink.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_apps,node_app_grid,node_home_guard,node_backdrop,node_usage,node_viewer,node_phone toneBlue
class node_setup_flow,node_pair_screen,node_pairing toneAmber
class node_remote_page,node_remote_service,node_remote_server,node_adb,node_irbas_server toneMint
class node_assistant_ui,node_orb,node_voice_wave toneRose
class node_irbas_link toneIndigo
```

## Components

### TV Launcher

- [Home screen](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/HomeActivity.java): `app/src/main/java/it/irbas/tv/HomeActivity.java`
- [App catalog](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/Apps.java): `app/src/main/java/it/irbas/tv/Apps.java`
- [All apps](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/AppsActivity.java): `app/src/main/java/it/irbas/tv/AppsActivity.java`
- [Home-key guard](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/HomeKeyService.java): `app/src/main/java/it/irbas/tv/HomeKeyService.java`
- [Animated backdrop](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/BackdropView.java): `app/src/main/java/it/irbas/tv/BackdropView.java`
- [App usage](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/Usage.java): `app/src/main/java/it/irbas/tv/Usage.java`

### Setup & Pairing

- [Setup guide](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/SetupActivity.java): `app/src/main/java/it/irbas/tv/SetupActivity.java`
- [Pairing screen](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/PairActivity.java): `app/src/main/java/it/irbas/tv/PairActivity.java`
- [Pairing data](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/Pairing.java): `app/src/main/java/it/irbas/tv/Pairing.java`

### Phone Remote

- [Remote web page](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/assets/remote.html): `app/src/main/assets/remote.html`
- [Remote service](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/RemoteService.java): `app/src/main/java/it/irbas/tv/RemoteService.java`
- [Remote HTTP server](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/RemoteServer.java): `app/src/main/java/it/irbas/tv/RemoteServer.java`
- [Local ADB](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/LocalAdb.java): `app/src/main/java/it/irbas/tv/LocalAdb.java`

### Voice Assistant

- [Voice assistant](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/AssistActivity.java): `app/src/main/java/it/irbas/tv/AssistActivity.java`
- [Assistant orb](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/OrbView.java): `app/src/main/java/it/irbas/tv/OrbView.java`
- [Voice animation](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/VoiceWave.java): `app/src/main/java/it/irbas/tv/VoiceWave.java`

### Irbas Integration

- [Server client](https://github.com/sabrizlt/irbas-tv/blob/main/app/src/main/java/it/irbas/tv/IrbasLink.java): `app/src/main/java/it/irbas/tv/IrbasLink.java`

### Other components

- **TV viewer**
- **Phone user**
- **Irbas server**

## Connections

- TV viewer → Home screen: opens (evidence: `app/src/main/java/it/irbas/tv/HomeActivity.java`)
- Home screen → App catalog: lists apps (evidence: `app/src/main/java/it/irbas/tv/HomeActivity.java`)
- Home screen → Animated backdrop: renders (evidence: `app/src/main/java/it/irbas/tv/HomeActivity.java`)
- Home screen → App usage: reads usage (evidence: `app/src/main/java/it/irbas/tv/HomeActivity.java`)
- Home screen → All apps: opens (evidence: `app/src/main/java/it/irbas/tv/HomeActivity.java`)
- Home-key guard → Home screen: redirects home (evidence: `app/src/main/java/it/irbas/tv/HomeKeyService.java`)
- Home screen → Remote service: starts (evidence: `app/src/main/java/it/irbas/tv/HomeActivity.java`)
- Remote service → Remote HTTP server: starts (evidence: `app/src/main/java/it/irbas/tv/RemoteService.java`)
- Phone user → Remote web page: uses (evidence: `README.md`)
- Remote web page → Remote HTTP server: sends commands (evidence: `README.md`)
- Remote HTTP server → App catalog: queries catalog (evidence: `app/src/main/java/it/irbas/tv/RemoteServer.java`)
- Remote HTTP server → Home-key guard: dispatches keys (evidence: `app/src/main/java/it/irbas/tv/RemoteServer.java`)
- Remote HTTP server → Local ADB: runs commands (evidence: `app/src/main/java/it/irbas/tv/RemoteServer.java`)
- Home screen → Pairing screen: opens pairing (evidence: `app/src/main/java/it/irbas/tv/HomeActivity.java`)
- Pairing screen → Pairing data: gets QR data (evidence: `app/src/main/java/it/irbas/tv/PairActivity.java`)
- Setup guide → Pairing screen: renders card (evidence: `app/src/main/java/it/irbas/tv/SetupActivity.java`)
- Home screen → Voice assistant: opens (evidence: `app/src/main/java/it/irbas/tv/HomeActivity.java`)
- Voice assistant → App catalog: opens app (evidence: `app/src/main/java/it/irbas/tv/AssistActivity.java`)
- Voice assistant → Assistant orb: renders (evidence: `app/src/main/java/it/irbas/tv/AssistActivity.java`)
- Voice assistant → Voice animation: renders (evidence: `app/src/main/java/it/irbas/tv/AssistActivity.java`)
- Voice assistant → Server client: sends question (evidence: `app/src/main/java/it/irbas/tv/AssistActivity.java`)
- Server client → Irbas server: HTTP requests (evidence: `app/src/main/java/it/irbas/tv/IrbasLink.java`)
