# jack02134x/prism-shell architecture

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

- Interactive diagram: https://gitdiagram.com/jack02134x/prism-shell
- Repository: https://github.com/jack02134x/prism-shell

## Overview

Prism is a Quickshell desktop shell for Hyprland. Its user-facing workflow spans the bar and launcher, dashboard and drawers, workspace/window tools, notifications, capture, session controls, and clock; wallpaper selection also drives system recoloring. The graph preserves these documented product areas and the runtime video-wallpaper helper. Source excerpts are limited to that helper, so most UI-to-service wiring is not asserted; documented README relationships are cited, and the helper’s external process calls use its excerpt.

Main entry points: [`scripts/live-wallpaper.py`](https://github.com/jack02134x/prism-shell/blob/main/scripts/live-wallpaper.py) (Video wallpaper player), [`modules/wallpaper/WallpaperPicker.qml`](https://github.com/jack02134x/prism-shell/blob/main/modules/wallpaper/WallpaperPicker.qml) (Wallpaper picker), [`shell.qml`](https://github.com/jack02134x/prism-shell/blob/main/shell.qml) (Shell entry), [`modules/bar/Bar.qml`](https://github.com/jack02134x/prism-shell/blob/main/modules/bar/Bar.qml) (Bar and island)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Shell surfaces"]
  node_shell["Shell entry<br/>[shell.qml]"]
  node_bar["Bar and island<br/>[Bar.qml]"]
  node_drawers["Edge drawers<br/>[Drawers.qml]"]
  node_launcher["Launcher<br/>[Launcher.qml]"]
  node_dashboard["Dashboard<br/>[Dashboard.qml]"]
  node_notifications["Notifications<br/>[Popups.qml]"]
  node_clock["Clock<br/>[ClockWindow.qml]"]
end

subgraph group_workspace["Workspace tools"]
  node_overview["Workspace overview<br/>[Overview.qml]"]
  node_switcher["Window switcher<br/>[Switcher.qml]"]
  node_capture["Screenshot and record<br/>[ThreadShot.qml]"]
end

subgraph group_personalization["Personalization"]
  node_wallpaper["Wallpaper picker"]
  node_video_wallpaper["Video wallpaper player<br/>[live-wallpaper.py]"]
  node_color_templates["Color templates"]
  node_matugen["matugen"]
  node_mpvpaper["mpvpaper"]
end

subgraph group_services["System services"]
  node_dashboard_services["Dashboard capabilities"]
  node_session["Lock and power<br/>[Lock.qml]"]
  node_polkit["Polkit agent<br/>[PolkitDialog.qml]"]
  node_cheatsheet["Keybind cheatsheet<br/>[Cheatsheet.qml]"]
end

node_user(("Desktop user"))
node_hyprland["Hyprland<br/>external system"]

node_user -->|"uses"| node_shell
node_user -->|"uses"| node_bar
node_user -->|"opens"| node_drawers
node_user -->|"launches from"| node_launcher
node_user -->|"opens"| node_dashboard
node_user -->|"receives"| node_notifications
node_user -->|"opens"| node_clock
node_user -->|"uses"| node_overview
node_user -->|"uses"| node_switcher
node_user -->|"captures with"| node_capture
node_user -->|"selects"| node_wallpaper
node_user -->|"locks or powers"| node_session
node_wallpaper -->|"triggers recoloring"| node_matugen
node_matugen -->|"uses templates"| node_color_templates
node_video_wallpaper -->|"starts playback"| node_mpvpaper
node_video_wallpaper -->|"queries monitors"| node_hyprland

click node_shell "https://github.com/jack02134x/prism-shell/blob/main/shell.qml"
click node_bar "https://github.com/jack02134x/prism-shell/blob/main/modules/bar/Bar.qml"
click node_drawers "https://github.com/jack02134x/prism-shell/blob/main/modules/drawers/Drawers.qml"
click node_launcher "https://github.com/jack02134x/prism-shell/blob/main/modules/launcher/Launcher.qml"
click node_dashboard "https://github.com/jack02134x/prism-shell/blob/main/modules/dashboard/Dashboard.qml"
click node_notifications "https://github.com/jack02134x/prism-shell/blob/main/modules/notifications/Popups.qml"
click node_clock "https://github.com/jack02134x/prism-shell/blob/main/modules/clock/ClockWindow.qml"
click node_overview "https://github.com/jack02134x/prism-shell/blob/main/modules/overview/Overview.qml"
click node_switcher "https://github.com/jack02134x/prism-shell/blob/main/modules/switcher/Switcher.qml"
click node_capture "https://github.com/jack02134x/prism-shell/blob/main/modules/screenshot/ThreadShot.qml"
click node_wallpaper "https://github.com/jack02134x/prism-shell/blob/main/modules/wallpaper/WallpaperPicker.qml"
click node_video_wallpaper "https://github.com/jack02134x/prism-shell/blob/main/scripts/live-wallpaper.py"
click node_color_templates "https://github.com/jack02134x/prism-shell/tree/main/matugen"
click node_dashboard_services "https://github.com/jack02134x/prism-shell/tree/main/services"
click node_session "https://github.com/jack02134x/prism-shell/blob/main/modules/lock/Lock.qml"
click node_polkit "https://github.com/jack02134x/prism-shell/blob/main/modules/polkit/PolkitDialog.qml"
click node_cheatsheet "https://github.com/jack02134x/prism-shell/blob/main/modules/cheatsheet/Cheatsheet.qml"

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_shell,node_bar,node_drawers,node_launcher,node_dashboard,node_notifications,node_clock,node_user toneBlue
class node_overview,node_switcher,node_capture toneAmber
class node_wallpaper,node_video_wallpaper,node_color_templates,node_matugen,node_mpvpaper toneMint
class node_dashboard_services,node_session,node_polkit,node_cheatsheet toneRose
class node_hyprland toneIndigo
```

## Components

### Shell surfaces

- [Shell entry](https://github.com/jack02134x/prism-shell/blob/main/shell.qml): `shell.qml`
- [Bar and island](https://github.com/jack02134x/prism-shell/blob/main/modules/bar/Bar.qml): `modules/bar/Bar.qml`
- [Edge drawers](https://github.com/jack02134x/prism-shell/blob/main/modules/drawers/Drawers.qml): `modules/drawers/Drawers.qml`
- [Launcher](https://github.com/jack02134x/prism-shell/blob/main/modules/launcher/Launcher.qml): `modules/launcher/Launcher.qml`
- [Dashboard](https://github.com/jack02134x/prism-shell/blob/main/modules/dashboard/Dashboard.qml): `modules/dashboard/Dashboard.qml`
- [Notifications](https://github.com/jack02134x/prism-shell/blob/main/modules/notifications/Popups.qml): `modules/notifications/Popups.qml`
- [Clock](https://github.com/jack02134x/prism-shell/blob/main/modules/clock/ClockWindow.qml): `modules/clock/ClockWindow.qml`

### Workspace tools

- [Workspace overview](https://github.com/jack02134x/prism-shell/blob/main/modules/overview/Overview.qml): `modules/overview/Overview.qml`
- [Window switcher](https://github.com/jack02134x/prism-shell/blob/main/modules/switcher/Switcher.qml): `modules/switcher/Switcher.qml`
- [Screenshot and record](https://github.com/jack02134x/prism-shell/blob/main/modules/screenshot/ThreadShot.qml): `modules/screenshot/ThreadShot.qml`

### Personalization

- [Wallpaper picker](https://github.com/jack02134x/prism-shell/blob/main/modules/wallpaper/WallpaperPicker.qml): `modules/wallpaper/WallpaperPicker.qml`
- [Video wallpaper player](https://github.com/jack02134x/prism-shell/blob/main/scripts/live-wallpaper.py): `scripts/live-wallpaper.py`
- [Color templates](https://github.com/jack02134x/prism-shell/tree/main/matugen): `matugen`
- **matugen**
- **mpvpaper**

### System services

- [Dashboard capabilities](https://github.com/jack02134x/prism-shell/tree/main/services): `services`
- [Lock and power](https://github.com/jack02134x/prism-shell/blob/main/modules/lock/Lock.qml): `modules/lock/Lock.qml`
- [Polkit agent](https://github.com/jack02134x/prism-shell/blob/main/modules/polkit/PolkitDialog.qml): `modules/polkit/PolkitDialog.qml`
- [Keybind cheatsheet](https://github.com/jack02134x/prism-shell/blob/main/modules/cheatsheet/Cheatsheet.qml): `modules/cheatsheet/Cheatsheet.qml`

### Other components

- **Desktop user**
- **Hyprland**: external system

## Connections

- Desktop user → Shell entry: uses (evidence: `README.md`)
- Desktop user → Bar and island: uses (evidence: `README.md`)
- Desktop user → Edge drawers: opens (evidence: `README.md`)
- Desktop user → Launcher: launches from (evidence: `README.md`)
- Desktop user → Dashboard: opens (evidence: `README.md`)
- Desktop user → Notifications: receives (evidence: `README.md`)
- Desktop user → Clock: opens (evidence: `README.md`)
- Desktop user → Workspace overview: uses (evidence: `README.md`)
- Desktop user → Window switcher: uses (evidence: `README.md`)
- Desktop user → Screenshot and record: captures with (evidence: `README.md`)
- Desktop user → Wallpaper picker: selects (evidence: `README.md`)
- Desktop user → Lock and power: locks or powers (evidence: `README.md`)
- Wallpaper picker → matugen: triggers recoloring (evidence: `README.md`)
- matugen → Color templates: uses templates (evidence: `README.md`)
- Video wallpaper player → mpvpaper: starts playback (evidence: `scripts/live-wallpaper.py`)
- Video wallpaper player → Hyprland: queries monitors (evidence: `scripts/live-wallpaper.py`)
