# abhiramgcos/ble_lhdc_5_cachyos architecture

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

## Overview

The repository provides a Tkinter BLE audio dashboard and a separate LHDC v5 setup guide. The dashboard workflow is: launch the GUI, discover connected BLE audio devices and their stream details, display live status, then let the user adjust codec, quality, or volume. The guide documents a separate PipeWire setup workflow. The excerpt confirms refresh, volume, and quality behavior; codec-switching and setup details are represented only at the level documented by the README.

Main entry points: [`ble-audio-dashboard.py`](https://github.com/abhiramgcos/ble_lhdc_5_cachyos/blob/main/ble-audio-dashboard.py) (Tkinter dashboard), [`lhdc-v5-setup.md`](https://github.com/abhiramgcos/ble_lhdc_5_cachyos/blob/main/lhdc-v5-setup.md) (LHDC setup guide)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Audio dashboard"]
  node_gui["Tkinter dashboard"]
  node_discovery["Device discovery"]
  node_stream["Stream details"]
  node_codec["Codec selection"]
  node_quality["Quality settings"]
  node_volume["Volume control"]
end

subgraph group_setup["LHDC setup"]
  node_setupguide["LHDC setup guide<br/>[lhdc-v5-setup.md]"]
end

node_user(("User"))
node_pipewire["PipeWire"]

node_user -->|"launches"| node_gui
node_gui -->|"refreshes via"| node_discovery
node_discovery -->|"parses streams"| node_stream
node_gui -->|"displays stats"| node_stream
node_user -->|"selects codec"| node_codec
node_codec -->|"sets profile"| node_pipewire
node_user -->|"chooses quality"| node_quality
node_quality -->|"sets quality"| node_pipewire
node_user -->|"adjusts volume"| node_volume
node_volume -->|"sets sink volume"| node_pipewire
node_user -->|"follows guide"| node_setupguide
node_setupguide -->|"configures codec"| node_pipewire

click node_gui "https://github.com/abhiramgcos/ble_lhdc_5_cachyos/blob/main/ble-audio-dashboard.py"
click node_discovery "https://github.com/abhiramgcos/ble_lhdc_5_cachyos/blob/main/ble-audio-dashboard.py"
click node_stream "https://github.com/abhiramgcos/ble_lhdc_5_cachyos/blob/main/ble-audio-dashboard.py"
click node_codec "https://github.com/abhiramgcos/ble_lhdc_5_cachyos/blob/main/ble-audio-dashboard.py"
click node_quality "https://github.com/abhiramgcos/ble_lhdc_5_cachyos/blob/main/ble-audio-dashboard.py"
click node_volume "https://github.com/abhiramgcos/ble_lhdc_5_cachyos/blob/main/ble-audio-dashboard.py"
click node_setupguide "https://github.com/abhiramgcos/ble_lhdc_5_cachyos/blob/main/lhdc-v5-setup.md"

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_gui,node_discovery,node_stream,node_codec,node_quality,node_volume,node_user toneBlue
class node_setupguide toneAmber
class node_pipewire toneIndigo
```

## Components

### Audio dashboard

- [Tkinter dashboard](https://github.com/abhiramgcos/ble_lhdc_5_cachyos/blob/main/ble-audio-dashboard.py): `ble-audio-dashboard.py`
- [Device discovery](https://github.com/abhiramgcos/ble_lhdc_5_cachyos/blob/main/ble-audio-dashboard.py): `ble-audio-dashboard.py`
- [Stream details](https://github.com/abhiramgcos/ble_lhdc_5_cachyos/blob/main/ble-audio-dashboard.py): `ble-audio-dashboard.py`
- [Codec selection](https://github.com/abhiramgcos/ble_lhdc_5_cachyos/blob/main/ble-audio-dashboard.py): `ble-audio-dashboard.py`
- [Quality settings](https://github.com/abhiramgcos/ble_lhdc_5_cachyos/blob/main/ble-audio-dashboard.py): `ble-audio-dashboard.py`
- [Volume control](https://github.com/abhiramgcos/ble_lhdc_5_cachyos/blob/main/ble-audio-dashboard.py): `ble-audio-dashboard.py`

### LHDC setup

- [LHDC setup guide](https://github.com/abhiramgcos/ble_lhdc_5_cachyos/blob/main/lhdc-v5-setup.md): `lhdc-v5-setup.md`

### Other components

- **User**
- **PipeWire**

## Connections

- User → Tkinter dashboard: launches (evidence: `README.md`)
- Tkinter dashboard → Device discovery: refreshes via (evidence: `ble-audio-dashboard.py`)
- Device discovery → Stream details: parses streams (evidence: `ble-audio-dashboard.py`)
- Tkinter dashboard → Stream details: displays stats (evidence: `README.md`)
- User → Codec selection: selects codec (evidence: `README.md`)
- Codec selection → PipeWire: sets profile (evidence: `README.md`)
- User → Quality settings: chooses quality (evidence: `README.md`)
- Quality settings → PipeWire: sets quality (evidence: `ble-audio-dashboard.py`)
- User → Volume control: adjusts volume (evidence: `README.md`)
- Volume control → PipeWire: sets sink volume (evidence: `ble-audio-dashboard.py`)
- User → LHDC setup guide: follows guide (evidence: `README.md`)
- LHDC setup guide → PipeWire: configures codec (evidence: `README.md`)
