# souandresouza/sddm-cadroc-theme architecture

> Architecture diagram of the GitHub repository souandresouza/sddm-cadroc-theme, 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/souandresouza/sddm-cadroc-theme
- Repository: https://github.com/souandresouza/sddm-cadroc-theme

## Overview

sddm-cadroc-theme is a Qt/QML SDDM login-screen theme. Its runtime presents the greeter and supports a Cadroc-generated color palette, with a repository palette as fallback; documented UI capabilities include keyboard-layout indication, virtual keyboard, and multi-monitor windows. The README identifies the greeter entry point and metadata, but no source excerpts were supplied, so component call relationships are not inferred. Installer behavior is excluded from this runtime map.

Main entry points: [`Main.qml`](https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Main.qml) (Greeter windows), [`metadata.desktop`](https://github.com/souandresouza/sddm-cadroc-theme/blob/main/metadata.desktop) (Theme metadata), [`Themes/cadroc-default.conf`](https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Themes/cadroc-default.conf) (Default palette)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_greeter["Greeter UI"]
  node_main["Greeter windows<br/>[Main.qml]"]
  node_metadata["Theme metadata<br/>[metadata.desktop]"]
end

subgraph group_components["UI Components"]
  node_login["Login form<br/>[LoginForm.qml]"]
  node_input["Input fields<br/>[Input.qml]"]
  node_layout["Layout indicator<br/>[KeyboardLayout.qml]"]
  node_clock["Clock<br/>[Clock.qml]"]
  node_session["Session controls<br/>[SessionButton.qml]"]
  node_system["System buttons<br/>[SystemButtons.qml]"]
  node_virtual["Virtual keyboard"]
  node_virtualbutton["Keyboard button"]
end

subgraph group_appearance["Appearance"]
  node_palette["Default palette"]
  node_backgrounds["Background assets"]
end

node_sddm(("SDDM greeter"))
node_cadroc(("Cadroc palette generator"))
node_palettefile["Generated palette file"]
node_qtkeyboard["Qt virtual keyboard"]

node_sddm -->|"uses theme"| node_main
node_sddm -->|"reads metadata"| node_metadata
node_cadroc -->|"generates palette"| node_palettefile
node_main -->|"reads colors"| node_palettefile
node_main -->|"uses fallback"| node_palette
node_main -.->|"optionally uses"| node_qtkeyboard

click node_main "https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Main.qml"
click node_metadata "https://github.com/souandresouza/sddm-cadroc-theme/blob/main/metadata.desktop"
click node_login "https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Components/LoginForm.qml"
click node_input "https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Components/Input.qml"
click node_layout "https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Components/KeyboardLayout.qml"
click node_clock "https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Components/Clock.qml"
click node_session "https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Components/SessionButton.qml"
click node_system "https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Components/SystemButtons.qml"
click node_virtual "https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Components/VirtualKeyboard.qml"
click node_virtualbutton "https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Components/VirtualKeyboardButton.qml"
click node_palette "https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Themes/cadroc-default.conf"
click node_backgrounds "https://github.com/souandresouza/sddm-cadroc-theme/tree/main/Backgrounds"

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_main,node_metadata toneBlue
class node_login,node_input,node_layout,node_clock,node_session,node_system,node_virtual,node_virtualbutton toneAmber
class node_palette,node_backgrounds toneMint
class node_sddm,node_cadroc,node_palettefile,node_qtkeyboard toneIndigo
```

## Components

### Greeter UI

- [Greeter windows](https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Main.qml): `Main.qml`
- [Theme metadata](https://github.com/souandresouza/sddm-cadroc-theme/blob/main/metadata.desktop): `metadata.desktop`

### UI Components

- [Login form](https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Components/LoginForm.qml): `Components/LoginForm.qml`
- [Input fields](https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Components/Input.qml): `Components/Input.qml`
- [Layout indicator](https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Components/KeyboardLayout.qml): `Components/KeyboardLayout.qml`
- [Clock](https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Components/Clock.qml): `Components/Clock.qml`
- [Session controls](https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Components/SessionButton.qml): `Components/SessionButton.qml`
- [System buttons](https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Components/SystemButtons.qml): `Components/SystemButtons.qml`
- [Virtual keyboard](https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Components/VirtualKeyboard.qml): `Components/VirtualKeyboard.qml`
- [Keyboard button](https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Components/VirtualKeyboardButton.qml): `Components/VirtualKeyboardButton.qml`

### Appearance

- [Default palette](https://github.com/souandresouza/sddm-cadroc-theme/blob/main/Themes/cadroc-default.conf): `Themes/cadroc-default.conf`
- [Background assets](https://github.com/souandresouza/sddm-cadroc-theme/tree/main/Backgrounds): `Backgrounds`

### Other components

- **SDDM greeter**
- **Cadroc palette generator**
- **Generated palette file**
- **Qt virtual keyboard**

## Connections

- SDDM greeter → Greeter windows: uses theme (evidence: `README.md`)
- SDDM greeter → Theme metadata: reads metadata (evidence: `README.md`)
- Cadroc palette generator → Generated palette file: generates palette (evidence: `README.md`)
- Greeter windows → Generated palette file: reads colors (evidence: `README.md`)
- Greeter windows → Default palette: uses fallback (evidence: `README.md`)
- Greeter windows → Qt virtual keyboard: optionally uses (evidence: `README.md`)
