# wiboma/hudiy architecture

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

- Interactive diagram: https://gitdiagram.com/wiboma/hudiy
- Repository: https://github.com/wiboma/hudiy

## Overview

Hudiy is a configurable, Linux-based vehicle infotainment system. Its broad user workflow is to configure the interface and extensions, interact through touch or keys, and use media, projections, vehicle data, and connected-device features. The supplied tree is primarily documentation, configuration, protocol definitions, and examples; the application implementation itself is not present, so the graph describes documented capabilities rather than internal runtime call flow. Relationships are supported by the README; unsampled subsystems use only paths established by the tree.

Main entry points: [`api/Api.proto`](https://github.com/wiboma/hudiy/blob/main/api/Api.proto) (API protocol), [`config/main_configuration.json`](https://github.com/wiboma/hudiy/blob/main/config/main_configuration.json) (System configuration), [`config/applications_menu.json`](https://github.com/wiboma/hudiy/blob/main/config/applications_menu.json) (Applications menu), [`config/applications.json`](https://github.com/wiboma/hudiy/blob/main/config/applications.json) (Custom applications)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Interface and customization"]
  node_hudiy["Hudiy infotainment"]
  node_mainconfig["System configuration"]
  node_appmenu["Applications menu"]
  node_applications["Custom applications<br/>[applications.json]"]
  node_dashboards["Dashboards<br/>[dashboards.json]"]
  node_shortcuts["Shortcuts<br/>[shortcuts.json]"]
  node_overlays["Overlays<br/>[overlays.json]"]
  node_translations["UI translations<br/>[hudiy.ts]"]
end

subgraph group_connectivity["Connectivity and projections"]
  node_androidauto["Android Auto<br/>[README.md]"]
  node_carplay["CarPlay<br/>[README.md]"]
  node_bluetooth["Bluetooth and telephony<br/>[README.md]"]
end

subgraph group_media["Media and vehicle data"]
  node_audio["Audio and players<br/>[README.md]"]
  node_vehicledata["Navigation and OBD-II<br/>[README.md]"]
  node_reversecamera["Reverse camera<br/>[README.md]"]
  node_externaldisplay["External displays"]
end

subgraph group_integration["Integration"]
  node_api["API protocol<br/>[Api.proto]"]
end

node_driver(("Driver"))
node_externalclient(("External systems"))

node_driver -->|"uses"| node_hudiy
node_driver -->|"configures"| node_mainconfig
node_driver -->|"customizes"| node_appmenu
node_driver -->|"creates"| node_applications
node_driver -->|"customizes"| node_dashboards
node_driver -->|"configures"| node_shortcuts
node_driver -->|"customizes"| node_overlays
node_driver -->|"uses"| node_androidauto
node_driver -->|"uses"| node_carplay
node_driver -->|"connects"| node_bluetooth
node_driver -->|"plays media"| node_audio
node_driver -->|"views data"| node_vehicledata
node_driver -->|"views feed"| node_reversecamera
node_hudiy -->|"renders to"| node_externaldisplay
node_externalclient -->|"uses protocol"| node_api
node_api -->|"exchanges messages"| node_hudiy

click node_mainconfig "https://github.com/wiboma/hudiy/blob/main/config/main_configuration.json"
click node_appmenu "https://github.com/wiboma/hudiy/blob/main/config/applications_menu.json"
click node_applications "https://github.com/wiboma/hudiy/blob/main/config/applications.json"
click node_dashboards "https://github.com/wiboma/hudiy/blob/main/config/dashboards.json"
click node_shortcuts "https://github.com/wiboma/hudiy/blob/main/config/shortcuts.json"
click node_overlays "https://github.com/wiboma/hudiy/blob/main/config/overlays.json"
click node_translations "https://github.com/wiboma/hudiy/blob/main/i18n/hudiy.ts"
click node_androidauto "https://github.com/wiboma/hudiy/blob/main/README.md"
click node_carplay "https://github.com/wiboma/hudiy/blob/main/README.md"
click node_bluetooth "https://github.com/wiboma/hudiy/blob/main/README.md"
click node_audio "https://github.com/wiboma/hudiy/blob/main/README.md"
click node_vehicledata "https://github.com/wiboma/hudiy/blob/main/README.md"
click node_reversecamera "https://github.com/wiboma/hudiy/blob/main/README.md"
click node_externaldisplay "https://github.com/wiboma/hudiy/tree/main/examples/external_display"
click node_api "https://github.com/wiboma/hudiy/blob/main/api/Api.proto"

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_hudiy,node_mainconfig,node_appmenu,node_applications,node_dashboards,node_shortcuts,node_overlays,node_translations toneBlue
class node_androidauto,node_carplay,node_bluetooth toneAmber
class node_audio,node_vehicledata,node_reversecamera,node_externaldisplay toneMint
class node_api toneRose
class node_driver,node_externalclient toneIndigo
```

## Components

### Interface and customization

- **Hudiy infotainment**
- [System configuration](https://github.com/wiboma/hudiy/blob/main/config/main_configuration.json): `config/main_configuration.json`
- [Applications menu](https://github.com/wiboma/hudiy/blob/main/config/applications_menu.json): `config/applications_menu.json`
- [Custom applications](https://github.com/wiboma/hudiy/blob/main/config/applications.json): `config/applications.json`
- [Dashboards](https://github.com/wiboma/hudiy/blob/main/config/dashboards.json): `config/dashboards.json`
- [Shortcuts](https://github.com/wiboma/hudiy/blob/main/config/shortcuts.json): `config/shortcuts.json`
- [Overlays](https://github.com/wiboma/hudiy/blob/main/config/overlays.json): `config/overlays.json`
- [UI translations](https://github.com/wiboma/hudiy/blob/main/i18n/hudiy.ts): `i18n/hudiy.ts`

### Connectivity and projections

- [Android Auto](https://github.com/wiboma/hudiy/blob/main/README.md): `README.md`
- [CarPlay](https://github.com/wiboma/hudiy/blob/main/README.md): `README.md`
- [Bluetooth and telephony](https://github.com/wiboma/hudiy/blob/main/README.md): `README.md`

### Media and vehicle data

- [Audio and players](https://github.com/wiboma/hudiy/blob/main/README.md): `README.md`
- [Navigation and OBD-II](https://github.com/wiboma/hudiy/blob/main/README.md): `README.md`
- [Reverse camera](https://github.com/wiboma/hudiy/blob/main/README.md): `README.md`
- [External displays](https://github.com/wiboma/hudiy/tree/main/examples/external_display): `examples/external_display`

### Integration

- [API protocol](https://github.com/wiboma/hudiy/blob/main/api/Api.proto): `api/Api.proto`

### Other components

- **Driver**
- **External systems**

## Connections

- Driver → Hudiy infotainment: uses (evidence: `README.md`)
- Driver → System configuration: configures (evidence: `README.md`)
- Driver → Applications menu: customizes (evidence: `README.md`)
- Driver → Custom applications: creates (evidence: `README.md`)
- Driver → Dashboards: customizes (evidence: `README.md`)
- Driver → Shortcuts: configures (evidence: `README.md`)
- Driver → Overlays: customizes (evidence: `README.md`)
- Driver → Android Auto: uses (evidence: `README.md`)
- Driver → CarPlay: uses (evidence: `README.md`)
- Driver → Bluetooth and telephony: connects (evidence: `README.md`)
- Driver → Audio and players: plays media (evidence: `README.md`)
- Driver → Navigation and OBD-II: views data (evidence: `README.md`)
- Driver → Reverse camera: views feed (evidence: `README.md`)
- Hudiy infotainment → External displays: renders to (evidence: `README.md`)
- External systems → API protocol: uses protocol (evidence: `README.md`)
- API protocol → Hudiy infotainment: exchanges messages (evidence: `api/Api.proto`)
