# virtualdrivers/linux-virtual-display-driver architecture

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

- Interactive diagram: https://gitdiagram.com/virtualdrivers/linux-virtual-display-driver
- Repository: https://github.com/virtualdrivers/linux-virtual-display-driver

## Overview

Linux Virtual Display Driver is a GTK3 application for creating, positioning, editing, and removing virtual displays through xrandr. Users launch the GUI, choose display settings and an output, and the manager configures the X server; state is saved for restoration on later launches. A separate NVIDIA setup flow writes system configuration so NVIDIA outputs can be enabled after a session restart. The map reflects the README and sampled entry points; some backend and dialog implementation details were not shown.

Main entry points: [`linux_vdd/display_manager.py`](https://github.com/virtualdrivers/linux-virtual-display-driver/blob/main/linux_vdd/display_manager.py) (Display manager), [`linux_vdd/app.py`](https://github.com/virtualdrivers/linux-virtual-display-driver/blob/main/linux_vdd/app.py) (Main window), [`linux_vdd/dialogs.py`](https://github.com/virtualdrivers/linux-virtual-display-driver/blob/main/linux_vdd/dialogs.py) (Display dialogs), [`vdd.py`](https://github.com/virtualdrivers/linux-virtual-display-driver/blob/main/vdd.py) (Application entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gui["GTK application"]
  node_app["Main window<br/>[app.py]"]
  node_display_dialogs["Display dialogs<br/>[dialogs.py]"]
end

subgraph group_display["Display management"]
  node_manager["Display manager<br/>[display_manager.py]"]
  node_output_detection["GPU and output detection<br/>[display_manager.py]"]
  node_modeline["CVT modeline generation<br/>[modeline.py]"]
end

subgraph group_nvidia["NVIDIA setup"]
  node_nvidia_dialog["NVIDIA setup dialog<br/>[dialogs.py]"]
  node_nvidia_config["NVIDIA system configuration"]
end

subgraph group_state["Persistent state"]
  node_config[("Saved display state")]
end

node_user(("Desktop user"))
node_launcher["Application entry<br/>[vdd.py]"]
node_xrandr["xrandr / X server"]

node_user -->|"launches"| node_launcher
node_launcher -->|"starts"| node_app
node_app -->|"creates"| node_manager
node_app -->|"opens"| node_display_dialogs
node_app -->|"opens"| node_nvidia_dialog
node_display_dialogs -->|"queries outputs"| node_manager
node_app -->|"creates display"| node_manager
node_app -->|"edits or removes"| node_manager
node_manager -->|"detects outputs"| node_output_detection
node_manager -->|"generates timing"| node_modeline
node_manager -->|"configures displays"| node_xrandr
node_manager -->|"loads and saves"| node_config
node_manager -->|"writes setup"| node_nvidia_config
node_nvidia_dialog -->|"submits outputs"| node_manager

click node_launcher "https://github.com/virtualdrivers/linux-virtual-display-driver/blob/main/vdd.py"
click node_app "https://github.com/virtualdrivers/linux-virtual-display-driver/blob/main/linux_vdd/app.py"
click node_display_dialogs "https://github.com/virtualdrivers/linux-virtual-display-driver/blob/main/linux_vdd/dialogs.py"
click node_nvidia_dialog "https://github.com/virtualdrivers/linux-virtual-display-driver/blob/main/linux_vdd/dialogs.py"
click node_manager "https://github.com/virtualdrivers/linux-virtual-display-driver/blob/main/linux_vdd/display_manager.py"
click node_output_detection "https://github.com/virtualdrivers/linux-virtual-display-driver/blob/main/linux_vdd/display_manager.py"
click node_modeline "https://github.com/virtualdrivers/linux-virtual-display-driver/blob/main/linux_vdd/modeline.py"

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_app,node_display_dialogs,node_user toneBlue
class node_manager,node_output_detection,node_modeline toneAmber
class node_nvidia_dialog,node_nvidia_config,node_xrandr toneMint
class node_config toneRose
class node_launcher toneTeal
```

## Components

### GTK application

- [Main window](https://github.com/virtualdrivers/linux-virtual-display-driver/blob/main/linux_vdd/app.py): `linux_vdd/app.py`
- [Display dialogs](https://github.com/virtualdrivers/linux-virtual-display-driver/blob/main/linux_vdd/dialogs.py): `linux_vdd/dialogs.py`

### Display management

- [Display manager](https://github.com/virtualdrivers/linux-virtual-display-driver/blob/main/linux_vdd/display_manager.py): `linux_vdd/display_manager.py`
- [GPU and output detection](https://github.com/virtualdrivers/linux-virtual-display-driver/blob/main/linux_vdd/display_manager.py): `linux_vdd/display_manager.py`
- [CVT modeline generation](https://github.com/virtualdrivers/linux-virtual-display-driver/blob/main/linux_vdd/modeline.py): `linux_vdd/modeline.py`

### NVIDIA setup

- [NVIDIA setup dialog](https://github.com/virtualdrivers/linux-virtual-display-driver/blob/main/linux_vdd/dialogs.py): `linux_vdd/dialogs.py`
- **NVIDIA system configuration**

### Persistent state

- **Saved display state**

### Other components

- **Desktop user**
- [Application entry](https://github.com/virtualdrivers/linux-virtual-display-driver/blob/main/vdd.py): `vdd.py`
- **xrandr / X server**

## Connections

- Desktop user → Application entry: launches (evidence: `README.md`)
- Application entry → Main window: starts (evidence: `vdd.py`)
- Main window → Display manager: creates (evidence: `linux_vdd/app.py`)
- Main window → Display dialogs: opens (evidence: `linux_vdd/app.py`)
- Main window → NVIDIA setup dialog: opens (evidence: `linux_vdd/app.py`)
- Display dialogs → Display manager: queries outputs (evidence: `linux_vdd/dialogs.py`)
- Main window → Display manager: creates display (evidence: `linux_vdd/app.py`)
- Main window → Display manager: edits or removes (evidence: `linux_vdd/app.py`)
- Display manager → GPU and output detection: detects outputs (evidence: `linux_vdd/display_manager.py`)
- Display manager → CVT modeline generation: generates timing (evidence: `linux_vdd/display_manager.py`)
- Display manager → xrandr / X server: configures displays (evidence: `README.md`)
- Display manager → Saved display state: loads and saves (evidence: `README.md`)
- Display manager → NVIDIA system configuration: writes setup (evidence: `README.md`)
- NVIDIA setup dialog → Display manager: submits outputs (evidence: `linux_vdd/app.py`)
