# marcocall96/glassremotetv architecture

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

- Interactive diagram: https://gitdiagram.com/marcocall96/glassremotetv
- Repository: https://github.com/marcocall96/glassremotetv

## Overview

GlassRemote is a phone-based web remote for Android TV, with two receiver options: an Android TV app that runs on the TV, or a Python receiver on a computer. The phone interface sends remote actions through the selected receiver; the TV app also adds link opening, health reporting, cache cleaning, and scheduled maintenance. The graph includes documented web-app capabilities, but their detailed implementation was not sampled; edges involving those capabilities are based on the README. TV-app internal calls are limited to relationships shown in excerpts or the source index.

Main entry points: [`tv-app/src/app/glassremote/tv/Server.java`](https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Server.java) (TV receiver app), [`docs/app.js`](https://github.com/marcocall96/glassremotetv/blob/main/docs/app.js) (Remote interface), [`tv-app/src/app/glassremote/tv/TvLink.java`](https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/TvLink.java) (TV command link), [`tv-app/src/app/glassremote/tv/Maintenance.java`](https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Maintenance.java) (Maintenance service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_phone["Phone web app"]
  node_web["Remote interface<br/>[app.js]"]
  node_webshell["PWA shell<br/>[index.html]"]
  node_offline["Offline support<br/>[service-worker.js]"]
  node_languages["Language selection<br/>[i18n.js]"]
end

subgraph group_computer["Computer receiver"]
  node_computer_receiver["Python receiver<br/>[bridge.py]"]
end

subgraph group_tvapp["TV app runtime"]
  node_tv_app["TV receiver app<br/>[Server.java]"]
  node_lifecycle["Service lifecycle"]
  node_tv_screen["TV setup screen<br/>[MainActivity.java]"]
  node_qr["QR code<br/>[Qr.java]"]
  node_auth["PIN and tokens<br/>[Auth.java]"]
end

subgraph group_control["TV control"]
  node_identity["ADB identity<br/>[Identity.java]"]
  node_adb["ADB transport<br/>[Adb.java]"]
  node_tvlink["TV command link<br/>[TvLink.java]"]
  node_keyinjector["Fast key client<br/>[KeyInjector.java]"]
  node_injector["Key injector<br/>[Injector.java]"]
  node_links["Link opening<br/>[Links.java]"]
end

subgraph group_maintenance["TV health and maintenance"]
  node_stats["Health statistics<br/>[Stats.java]"]
  node_maintenance["Maintenance service<br/>[Maintenance.java]"]
  node_schedule["Restart schedule<br/>[Schedule.java]"]
end

node_user(("Phone user"))
node_tv(("Android TV"))

node_user -->|"uses"| node_web
node_webshell -->|"hosts interface"| node_web
node_web -->|"supports offline"| node_offline
node_web -->|"offers languages"| node_languages
node_web -->|"sends remote actions"| node_computer_receiver
node_computer_receiver -->|"controls via Remote v2"| node_tv
node_web -->|"sends remote actions"| node_tv_app
node_tv_app -->|"serves interface and controls locally"| node_tv
node_lifecycle -->|"starts server"| node_tv_app
node_lifecycle -->|"starts TV link"| node_tvlink
node_lifecycle -->|"starts maintenance"| node_maintenance
node_tv_screen -->|"shows address and status"| node_tv_app
node_tv_screen -->|"renders code"| node_qr
node_tv_app -->|"checks protected calls"| node_auth
node_tv_app -->|"routes TV commands"| node_tvlink
node_tv_app -->|"handles maintenance requests"| node_maintenance
node_tv_app -->|"formats health data"| node_stats
node_tv_app -->|"uses restart schedule"| node_schedule
node_tvlink -->|"sends TV commands"| node_adb
node_tvlink -->|"sends fast keys"| node_keyinjector
node_keyinjector -->|"starts helper"| node_injector
node_keyinjector -->|"opens debug stream"| node_adb
node_adb -->|"authenticates debug connection"| node_identity
node_maintenance -->|"reboots when due"| node_tvlink
node_maintenance -->|"computes next run"| node_schedule

click node_web "https://github.com/marcocall96/glassremotetv/blob/main/docs/app.js"
click node_webshell "https://github.com/marcocall96/glassremotetv/blob/main/docs/index.html"
click node_offline "https://github.com/marcocall96/glassremotetv/blob/main/docs/service-worker.js"
click node_languages "https://github.com/marcocall96/glassremotetv/blob/main/docs/i18n.js"
click node_computer_receiver "https://github.com/marcocall96/glassremotetv/blob/main/receiver/bridge.py"
click node_tv_app "https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Server.java"
click node_lifecycle "https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/ReceiverService.java"
click node_tv_screen "https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/MainActivity.java"
click node_qr "https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Qr.java"
click node_auth "https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Auth.java"
click node_identity "https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Identity.java"
click node_adb "https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Adb.java"
click node_tvlink "https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/TvLink.java"
click node_keyinjector "https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/KeyInjector.java"
click node_injector "https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Injector.java"
click node_links "https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Links.java"
click node_stats "https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Stats.java"
click node_maintenance "https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Maintenance.java"
click node_schedule "https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Schedule.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_web,node_webshell,node_offline,node_languages,node_user toneBlue
class node_computer_receiver toneAmber
class node_tv_app,node_lifecycle,node_tv_screen,node_qr,node_auth toneMint
class node_identity,node_adb,node_tvlink,node_keyinjector,node_injector,node_links toneRose
class node_stats,node_maintenance,node_schedule,node_tv toneIndigo
```

## Components

### Phone web app

- [Remote interface](https://github.com/marcocall96/glassremotetv/blob/main/docs/app.js): `docs/app.js`
- [PWA shell](https://github.com/marcocall96/glassremotetv/blob/main/docs/index.html): `docs/index.html`
- [Offline support](https://github.com/marcocall96/glassremotetv/blob/main/docs/service-worker.js): `docs/service-worker.js`
- [Language selection](https://github.com/marcocall96/glassremotetv/blob/main/docs/i18n.js): `docs/i18n.js`

### Computer receiver

- [Python receiver](https://github.com/marcocall96/glassremotetv/blob/main/receiver/bridge.py): `receiver/bridge.py`

### TV app runtime

- [TV receiver app](https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Server.java): `tv-app/src/app/glassremote/tv/Server.java`
- [Service lifecycle](https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/ReceiverService.java): `tv-app/src/app/glassremote/tv/ReceiverService.java`
- [TV setup screen](https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/MainActivity.java): `tv-app/src/app/glassremote/tv/MainActivity.java`
- [QR code](https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Qr.java): `tv-app/src/app/glassremote/tv/Qr.java`
- [PIN and tokens](https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Auth.java): `tv-app/src/app/glassremote/tv/Auth.java`

### TV control

- [ADB identity](https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Identity.java): `tv-app/src/app/glassremote/tv/Identity.java`
- [ADB transport](https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Adb.java): `tv-app/src/app/glassremote/tv/Adb.java`
- [TV command link](https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/TvLink.java): `tv-app/src/app/glassremote/tv/TvLink.java`
- [Fast key client](https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/KeyInjector.java): `tv-app/src/app/glassremote/tv/KeyInjector.java`
- [Key injector](https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Injector.java): `tv-app/src/app/glassremote/tv/Injector.java`
- [Link opening](https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Links.java): `tv-app/src/app/glassremote/tv/Links.java`

### TV health and maintenance

- [Health statistics](https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Stats.java): `tv-app/src/app/glassremote/tv/Stats.java`
- [Maintenance service](https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Maintenance.java): `tv-app/src/app/glassremote/tv/Maintenance.java`
- [Restart schedule](https://github.com/marcocall96/glassremotetv/blob/main/tv-app/src/app/glassremote/tv/Schedule.java): `tv-app/src/app/glassremote/tv/Schedule.java`

### Other components

- **Phone user**
- **Android TV**

## Connections

- Phone user → Remote interface: uses (evidence: `README.md`)
- PWA shell → Remote interface: hosts interface (evidence: `README.md`)
- Remote interface → Offline support: supports offline (evidence: `README.md`)
- Remote interface → Language selection: offers languages (evidence: `README.md`)
- Remote interface → Python receiver: sends remote actions (evidence: `README.md`)
- Python receiver → Android TV: controls via Remote v2 (evidence: `README.md`)
- Remote interface → TV receiver app: sends remote actions (evidence: `README.md`)
- TV receiver app → Android TV: serves interface and controls locally (evidence: `README.md`)
- Service lifecycle → TV receiver app: starts server (evidence: `tv-app/src/app/glassremote/tv/ReceiverService.java`)
- Service lifecycle → TV command link: starts TV link (evidence: `tv-app/src/app/glassremote/tv/ReceiverService.java`)
- Service lifecycle → Maintenance service: starts maintenance (evidence: `tv-app/src/app/glassremote/tv/ReceiverService.java`)
- TV setup screen → TV receiver app: shows address and status (evidence: `tv-app/src/app/glassremote/tv/MainActivity.java`)
- TV setup screen → QR code: renders code (evidence: `tv-app/src/app/glassremote/tv/MainActivity.java`)
- TV receiver app → PIN and tokens: checks protected calls (evidence: `tv-app/src/app/glassremote/tv/Server.java`)
- TV receiver app → TV command link: routes TV commands (evidence: `tv-app/src/app/glassremote/tv/Server.java`)
- TV receiver app → Maintenance service: handles maintenance requests (evidence: `tv-app/src/app/glassremote/tv/Server.java`)
- TV receiver app → Health statistics: formats health data (evidence: `tv-app/src/app/glassremote/tv/Server.java`)
- TV receiver app → Restart schedule: uses restart schedule (evidence: `tv-app/src/app/glassremote/tv/Server.java`)
- TV command link → ADB transport: sends TV commands (evidence: `tv-app/src/app/glassremote/tv/TvLink.java`)
- TV command link → Fast key client: sends fast keys (evidence: `tv-app/src/app/glassremote/tv/TvLink.java`)
- Fast key client → Key injector: starts helper (evidence: `tv-app/src/app/glassremote/tv/KeyInjector.java`)
- Fast key client → ADB transport: opens debug stream (evidence: `tv-app/src/app/glassremote/tv/KeyInjector.java`)
- ADB transport → ADB identity: authenticates debug connection (evidence: `tv-app/src/app/glassremote/tv/Adb.java`)
- Maintenance service → TV command link: reboots when due (evidence: `tv-app/src/app/glassremote/tv/Maintenance.java`)
- Maintenance service → Restart schedule: computes next run (evidence: `tv-app/src/app/glassremote/tv/Maintenance.java`)
