# waydabber/betterdisplay architecture

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

- Interactive diagram: https://gitdiagram.com/waydabber/betterdisplay
- Repository: https://github.com/waydabber/betterdisplay

## Overview

BetterDisplay is a macOS menu-bar application for configuring displays and controlling connected hardware. The documented user workflow is to choose display controls or arrangement actions in the app, adjust display behavior, and have the selected changes applied to supported displays. The README also describes distinct capabilities for image processing, virtual displays and streaming, hardware/network control, and automation and diagnostics. Only README.md is present; implementation paths and internal call relationships cannot be verified, so component paths are null and edges show documented relationships only.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["App interface"]
  node_menu["Menu bar controls"]
  node_sidebar["Optional sidebar"]
  node_console["Console and CLI"]
end

subgraph group_display["Display management"]
  node_scaling["HiDPI scaling"]
  node_brightness["Brightness and HDR"]
  node_arrangement["Display arrangement"]
  node_virtual["Virtual screens"]
  node_overrides["Display overrides"]
  node_connection["Connection management"]
  node_groups["Display groups"]
  node_profiles["Color profiles"]
end

subgraph group_media["Image and streaming"]
  node_filters["Image filters and LUTs"]
  node_pip["PIP and streaming"]
end

subgraph group_control["Hardware and automation"]
  node_ddc["DDC and HDMI-CEC"]
  node_network["Network device control"]
  node_automation["Shortcuts and automation"]
  node_diagnostics["Display diagnostics"]
end

node_user(("Mac user"))
node_displays["Mac displays"]
node_tv["Supported TVs"]
node_receivers["Yamaha receivers"]

node_user -->|"uses"| node_menu
node_user -->|"can choose"| node_sidebar
node_user -->|"accesses"| node_console
node_menu -->|"configures"| node_scaling
node_menu -->|"controls"| node_brightness
node_menu -->|"arranges"| node_arrangement
node_menu -->|"manages"| node_virtual
node_menu -->|"selects"| node_profiles
node_menu -->|"manages"| node_connection
node_menu -->|"manages"| node_groups
node_menu -->|"configures"| node_overrides
node_menu -->|"opens"| node_pip
node_pip -->|"applies"| node_filters
node_groups -->|"syncs"| node_brightness
node_groups -->|"syncs"| node_filters
node_scaling -->|"scales"| node_displays
node_brightness -->|"adjusts"| node_displays
node_arrangement -->|"arranges"| node_displays
node_virtual -->|"creates"| node_displays
node_connection -->|"connects"| node_displays
node_ddc -->|"controls"| node_displays
node_ddc -->|"controls via CEC"| node_tv
node_network -->|"controls"| node_tv
node_network -->|"controls"| node_receivers
node_console -->|"supports"| node_automation
node_console -->|"reports"| node_diagnostics

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_menu,node_sidebar,node_console,node_user toneBlue
class node_scaling,node_brightness,node_arrangement,node_virtual,node_overrides,node_connection,node_groups,node_profiles toneAmber
class node_filters,node_pip toneMint
class node_ddc,node_network,node_automation,node_diagnostics toneRose
class node_displays,node_tv,node_receivers toneIndigo
```

## Components

### App interface

- **Menu bar controls**
- **Optional sidebar**
- **Console and CLI**

### Display management

- **HiDPI scaling**
- **Brightness and HDR**
- **Display arrangement**
- **Virtual screens**
- **Display overrides**
- **Connection management**
- **Display groups**
- **Color profiles**

### Image and streaming

- **Image filters and LUTs**
- **PIP and streaming**

### Hardware and automation

- **DDC and HDMI-CEC**
- **Network device control**
- **Shortcuts and automation**
- **Display diagnostics**

### Other components

- **Mac user**
- **Mac displays**
- **Supported TVs**
- **Yamaha receivers**

## Connections

- Mac user → Menu bar controls: uses (evidence: `README.md`)
- Mac user → Optional sidebar: can choose (evidence: `README.md`)
- Mac user → Console and CLI: accesses (evidence: `README.md`)
- Menu bar controls → HiDPI scaling: configures (evidence: `README.md`)
- Menu bar controls → Brightness and HDR: controls (evidence: `README.md`)
- Menu bar controls → Display arrangement: arranges (evidence: `README.md`)
- Menu bar controls → Virtual screens: manages (evidence: `README.md`)
- Menu bar controls → Color profiles: selects (evidence: `README.md`)
- Menu bar controls → Connection management: manages (evidence: `README.md`)
- Menu bar controls → Display groups: manages (evidence: `README.md`)
- Menu bar controls → Display overrides: configures (evidence: `README.md`)
- Menu bar controls → PIP and streaming: opens (evidence: `README.md`)
- PIP and streaming → Image filters and LUTs: applies (evidence: `README.md`)
- Display groups → Brightness and HDR: syncs (evidence: `README.md`)
- Display groups → Image filters and LUTs: syncs (evidence: `README.md`)
- HiDPI scaling → Mac displays: scales (evidence: `README.md`)
- Brightness and HDR → Mac displays: adjusts (evidence: `README.md`)
- Display arrangement → Mac displays: arranges (evidence: `README.md`)
- Virtual screens → Mac displays: creates (evidence: `README.md`)
- Connection management → Mac displays: connects (evidence: `README.md`)
- DDC and HDMI-CEC → Mac displays: controls (evidence: `README.md`)
- DDC and HDMI-CEC → Supported TVs: controls via CEC (evidence: `README.md`)
- Network device control → Supported TVs: controls (evidence: `README.md`)
- Network device control → Yamaha receivers: controls (evidence: `README.md`)
- Console and CLI → Shortcuts and automation: supports (evidence: `README.md`)
- Console and CLI → Display diagnostics: reports (evidence: `README.md`)
