Skip to content

omarchy-quickshell

Version 2026.243.1855
Repo box/github.com/opencharly/layer-omarchy-shell:v2026.243.1941

Runs Omarchy’s Quickshell desktop shell — its bar, notifier, launcher, OSD and lockscreen, as one supervised service. In Omarchy 4.x the entire desktop shell is a single Quickshell QML tree shipped by the omarchy package at /usr/share/omarchy/shell. There is no waybar, no mako, no walker and no swayosd to install separately — those were the 3.x stack. This candy installs Quickshell and supervises that tree directly. Verifiable on the built image: the quickshell binary and the shell tree are present; at deploy, the shell reaches a stable supervised RUNNING state against the compositor’s Wayland socket.

  • omarchy-shell

This candy’s plan: — the runnable spec charly check executes against a live deployment. check: steps are idempotent probes; run: steps change state.

Intent Step
check the Quickshell runtime is installed
check the Omarchy shell QML tree this service runs is present
agent-check with the compositor up, the Quickshell shell reaches a stable supervised RUNNING state and draws its bar into the captured desktop
check service=omarchy-shell
check command=supervisorctl status omarchy-shell shows a stable uptime