# ovionekenoby/remote-01 architecture

> Architecture diagram of the GitHub repository ovionekenoby/remote-01, 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/ovionekenoby/remote-01
- Repository: https://github.com/ovionekenoby/remote-01

## Overview

REMOTE//01 is ESP32-S3 firmware for a touchscreen remote paired with a TUNER over authenticated RTCP/1. The main user flow is HOME interaction—volume, playback, source, and catalog actions—through the control runtime and RTCP client to the TUNER, with authoritative observations returned for presentation. SETTINGS and INFO expose device state and power behavior; separate branches provide Wi-Fi setup, local OTA, diagnostics, artwork, and persistence. Several runtime connections are documented rather than visible in the excerpts, so those edges cite the README; unsampled subsystem internals are represented at their existing directory paths.

Main entry points: [`components/user_app/user_app.cpp`](https://github.com/ovionekenoby/remote-01/blob/main/components/user_app/user_app.cpp) (HOME / SETTINGS / INFO), [`components/network_manager/runtime.cpp`](https://github.com/ovionekenoby/remote-01/blob/main/components/network_manager/runtime.cpp) (Wi-Fi and setup), [`components/control_home/runtime.cpp`](https://github.com/ovionekenoby/remote-01/blob/main/components/control_home/runtime.cpp) (Control API), [`components/rtcp_client/client.cpp`](https://github.com/ovionekenoby/remote-01/blob/main/components/rtcp_client/client.cpp) (RTCP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_ui["HOME / SETTINGS / INFO<br/>[user_app.cpp]"]
  node_artwork["Artwork presentation<br/>[online_runtime.cpp]"]
end

subgraph group_control["Tuner control"]
  node_controlhome["Control API<br/>[runtime.cpp]"]
  node_controlcore["Control session<br/>[core.cpp]"]
  node_rtcp["RTCP client<br/>[client.cpp]"]
end

subgraph group_services["Device services"]
  node_persistence[("Remote persistence<br/>[backend.cpp]")]
  node_network["Wi-Fi and setup<br/>[runtime.cpp]"]
  node_ota["Local firmware update<br/>[service.cpp]"]
  node_diagnostics["HTTP diagnostics<br/>[service.cpp]"]
  node_power["Power management<br/>[runtime.cpp]"]
end

subgraph group_platform["Platform and display"]
  node_lvgl["LVGL rendering<br/>[lvgl.h]"]
  node_display["Display and touch<br/>[main.cpp]"]
  node_physical["Physical input<br/>[model.hpp]"]
end

node_person(("Remote user"))
node_tuner["Paired TUNER"]

node_person -->|"uses"| node_ui
node_ui -->|"requests catalog"| node_controlhome
node_controlhome -->|"owns session"| node_controlcore
node_controlhome -->|"dispatches commands"| node_rtcp
node_rtcp -->|"authenticated RTCP/1"| node_tuner
node_tuner -->|"returns observations"| node_rtcp
node_ui -->|"shows artwork"| node_artwork
node_ui -->|"shows setup state"| node_network
node_network -.->|"uses saved credentials"| node_persistence
node_network -->|"configures lifecycle"| node_ota
node_network -->|"services diagnostics"| node_diagnostics
node_ui -->|"sets idle delays"| node_power
node_power -->|"coordinates sleep"| node_network
node_ui -->|"builds screens"| node_lvgl
node_display -->|"registers display input"| node_lvgl
node_physical -->|"signals activity"| node_power

click node_ui "https://github.com/ovionekenoby/remote-01/blob/main/components/user_app/user_app.cpp"
click node_artwork "https://github.com/ovionekenoby/remote-01/blob/main/components/artwork/online_runtime.cpp"
click node_controlhome "https://github.com/ovionekenoby/remote-01/blob/main/components/control_home/runtime.cpp"
click node_controlcore "https://github.com/ovionekenoby/remote-01/blob/main/components/control/core.cpp"
click node_rtcp "https://github.com/ovionekenoby/remote-01/blob/main/components/rtcp_client/client.cpp"
click node_persistence "https://github.com/ovionekenoby/remote-01/blob/main/components/remote_persistence/backend.cpp"
click node_network "https://github.com/ovionekenoby/remote-01/blob/main/components/network_manager/runtime.cpp"
click node_ota "https://github.com/ovionekenoby/remote-01/blob/main/components/ota_service/service.cpp"
click node_diagnostics "https://github.com/ovionekenoby/remote-01/blob/main/components/diagnostics/service.cpp"
click node_power "https://github.com/ovionekenoby/remote-01/blob/main/components/power_management/runtime.cpp"
click node_lvgl "https://github.com/ovionekenoby/remote-01/blob/main/components/lvgl/lvgl.h"
click node_display "https://github.com/ovionekenoby/remote-01/blob/main/main/main.cpp"
click node_physical "https://github.com/ovionekenoby/remote-01/blob/main/include/physical_input/model.hpp"

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_ui,node_artwork,node_person toneBlue
class node_controlhome,node_controlcore,node_rtcp toneAmber
class node_persistence,node_network,node_ota,node_diagnostics,node_power toneMint
class node_lvgl,node_display,node_physical toneRose
class node_tuner toneIndigo
```

## Components

### User interface

- [HOME / SETTINGS / INFO](https://github.com/ovionekenoby/remote-01/blob/main/components/user_app/user_app.cpp): `components/user_app/user_app.cpp`
- [Artwork presentation](https://github.com/ovionekenoby/remote-01/blob/main/components/artwork/online_runtime.cpp): `components/artwork/online_runtime.cpp`

### Tuner control

- [Control API](https://github.com/ovionekenoby/remote-01/blob/main/components/control_home/runtime.cpp): `components/control_home/runtime.cpp`
- [Control session](https://github.com/ovionekenoby/remote-01/blob/main/components/control/core.cpp): `components/control/core.cpp`
- [RTCP client](https://github.com/ovionekenoby/remote-01/blob/main/components/rtcp_client/client.cpp): `components/rtcp_client/client.cpp`

### Device services

- [Remote persistence](https://github.com/ovionekenoby/remote-01/blob/main/components/remote_persistence/backend.cpp): `components/remote_persistence/backend.cpp`
- [Wi-Fi and setup](https://github.com/ovionekenoby/remote-01/blob/main/components/network_manager/runtime.cpp): `components/network_manager/runtime.cpp`
- [Local firmware update](https://github.com/ovionekenoby/remote-01/blob/main/components/ota_service/service.cpp): `components/ota_service/service.cpp`
- [HTTP diagnostics](https://github.com/ovionekenoby/remote-01/blob/main/components/diagnostics/service.cpp): `components/diagnostics/service.cpp`
- [Power management](https://github.com/ovionekenoby/remote-01/blob/main/components/power_management/runtime.cpp): `components/power_management/runtime.cpp`

### Platform and display

- [LVGL rendering](https://github.com/ovionekenoby/remote-01/blob/main/components/lvgl/lvgl.h): `components/lvgl/lvgl.h`
- [Display and touch](https://github.com/ovionekenoby/remote-01/blob/main/main/main.cpp): `main/main.cpp`
- [Physical input](https://github.com/ovionekenoby/remote-01/blob/main/include/physical_input/model.hpp): `include/physical_input/model.hpp`

### Other components

- **Remote user**
- **Paired TUNER**

## Connections

- Remote user → HOME / SETTINGS / INFO: uses (evidence: `README.md`)
- HOME / SETTINGS / INFO → Control API: requests catalog (evidence: `components/user_app/user_app.cpp`)
- Control API → Control session: owns session (evidence: `components/control_home/runtime.cpp`)
- Control API → RTCP client: dispatches commands (evidence: `components/control_home/runtime.cpp`)
- RTCP client → Paired TUNER: authenticated RTCP/1 (evidence: `README.md`)
- Paired TUNER → RTCP client: returns observations (evidence: `README.md`)
- HOME / SETTINGS / INFO → Artwork presentation: shows artwork (evidence: `components/user_app/user_app.cpp`)
- HOME / SETTINGS / INFO → Wi-Fi and setup: shows setup state (evidence: `README.md`)
- Wi-Fi and setup → Remote persistence: uses saved credentials
- Wi-Fi and setup → Local firmware update: configures lifecycle (evidence: `components/network_manager/runtime.cpp`)
- Wi-Fi and setup → HTTP diagnostics: services diagnostics (evidence: `components/network_manager/runtime.cpp`)
- HOME / SETTINGS / INFO → Power management: sets idle delays (evidence: `README.md`)
- Power management → Wi-Fi and setup: coordinates sleep (evidence: `components/power_management/runtime.cpp`)
- HOME / SETTINGS / INFO → LVGL rendering: builds screens (evidence: `components/user_app/user_app.cpp`)
- Display and touch → LVGL rendering: registers display input (evidence: `main/main.cpp`)
- Physical input → Power management: signals activity
