How crazybadger/omarchy-workspace-ribbon works
Workspace Ribbon is a Quickshell overlay for viewing and switching Hyprland workspaces, with app icons resolved for windows on each workspace. The documented runtime is concentrated in Ribbon.qml; manifest.json declares the overlay plugin. Source excerpts were not available, so relationships below follow the README rather than source-level inspection.
Main entry points: Ribbon.qml Workspace ribbon · manifest.json Overlay manifest
Components 9
Ribbon overlay
- Overlay manifest
manifest.json - Workspace ribbon
Ribbon.qml
Workspace data
- Hyprland workspaces
- Wayland toplevels
Icon resolution
- XDG icon files
- Qt themed icons
- Desktop entries
Other components
- User
- Omarchy shell
Connections 9
- Omarchy shell → Overlay manifest: loads plugin
- User → Omarchy shell: invokes toggle
- Omarchy shell → Workspace ribbon: shows overlay
- Workspace ribbon → Hyprland workspaces: reads workspaces
- Workspace ribbon → Wayland toplevels: matches titles
- Workspace ribbon → XDG icon files: indexes icons
- Workspace ribbon → Qt themed icons: falls back
- Workspace ribbon → Desktop entries: matches titles
- Workspace ribbon → Hyprland workspaces: focuses workspace