How jack02134x/prism-shell works
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: live-wallpaper.py Video wallpaper player · WallpaperPicker.qml Wallpaper picker · shell.qml Shell entry · Bar.qml Bar and island
Components 21
Shell surfaces
- Shell entry
shell.qml - Bar and island
modules/bar/Bar.qml - Edge drawers
modules/drawers/Drawers.qml - Launcher
modules/launcher/Launcher.qml - Dashboard
modules/dashboard/Dashboard.qml - Notifications
modules/notifications/Popups.qml - Clock
modules/clock/ClockWindow.qml
Workspace tools
- Workspace overview
modules/overview/Overview.qml - Window switcher
modules/switcher/Switcher.qml - Screenshot and record
modules/screenshot/ThreadShot.qml
Personalization
- Wallpaper picker
modules/wallpaper/WallpaperPicker.qml - Video wallpaper player
scripts/live-wallpaper.py - Color templates
matugen - matugen
- mpvpaper
System services
- Dashboard capabilities
services - Lock and power
modules/lock/Lock.qml - Polkit agent
modules/polkit/PolkitDialog.qml - Keybind cheatsheet
modules/cheatsheet/Cheatsheet.qml
Other components
- Desktop user
- Hyprland
Connections 16
- Desktop user → Shell entry: uses
README.md - Desktop user → Bar and island: uses
README.md - Desktop user → Edge drawers: opens
README.md - Desktop user → Launcher: launches from
README.md - Desktop user → Dashboard: opens
README.md - Desktop user → Notifications: receives
README.md - Desktop user → Clock: opens
README.md - Desktop user → Workspace overview: uses
README.md - Desktop user → Window switcher: uses
README.md - Desktop user → Screenshot and record: captures with
README.md - Desktop user → Wallpaper picker: selects
README.md - Desktop user → Lock and power: locks or powers
README.md - Wallpaper picker → matugen: triggers recoloring
README.md - matugen → Color templates: uses templates
README.md - Video wallpaper player → mpvpaper: starts playback
scripts/live-wallpaper.py - Video wallpaper player → Hyprland: queries monitors
scripts/live-wallpaper.py