Omarchy 4 prep: Quickshell shell migration, menu selector compatibility, resume monitor, QML lint workflow

[timmo001]

Summary

Prepares and carries out the shell-and-bar half of the Omarchy 4 Quickshell migration: relocates the Home Assistant bar producer, adds reusable Quickshell bar-widget plugins, generates the per-host shell.json on stow, removes Waybar from the dot tooling, and keeps menu selection, the resume monitor, and a QML lint workflow in place. The bar migration is VM-validated.

Supersedes #12 (closed) and the earlier #11. Rebased onto the current distro/arch-omarchy.

Migration plan and remaining work: dot-migration/omarchy-quickshell/README.md

Complete

Quickshell bar migration (VM-validated)

• ha-bar-module relocated from the Waybar repo for Quickshell (parent detection, no WAYBAR_* env)
• timmo.command and timmo.stream-command reusable bar-widget plugins (per-class colours, hide classes, click actions, IPC refresh, grey loading placeholder)
• Per-host ~/.config/omarchy/shell.json auto-generated on dot stow (dot/src/lib/omarchyShellConfig.ts), built-ins mapped through, custom widgets instantiated with their command/clicks/colours
• Custom modules routed through the timmo.* widgets rather than the built-in command module
• Grey loading placeholder for the git modules plus on-resume IPC refresh; git watcher cache/lock reset preserved

Waybar removal

• Waybar integration removed from dot (repo sync, doctor checks, git-diff cache) and remaining launch/cache leftovers cleaned up; the timmo001/omarchy-waybar repo is retained but no longer cloned

Shell-script and tooling compatibility

• menu_select() helper in twitch-menu, workspace-menu, workspace-relayout, targeting Omarchy 4 only (Walker fallback dropped)
• on-resume-monitor dbus sleep/wake monitor plus dot-on-resume-monitor.service, with a dot doctor check for script and unit presence/enablement
• systemd doctor checks deduplicated behind a shared checkRequiredUserUnitSetup helper (no behaviour change)
• tmux adopts Omarchy 4 keybindings, keeping the custom set-titles

CI and docs

• .github/workflows/quickshell-lint.yml runs qmllint over all *.qml (module-dependent categories disabled so genuine syntax errors still fail)
• Docs scrubbed of Waybar; migration plan trimmed to the remaining work

What's left

Tracked in the linked migration plan, not in this PR:

• Hypr Lua migration and its VM validation (timmo001/omarchy-hypr)
• Remaining VM validation (Hypr start/reload/configerrors, lock/idle/wake, network)
• Promotion criteria and open decisions in the migration README (future omarchy-quickshell repo layout, upstream PR status, git-modules-as-QML-plugin, HA-streaming approach, shared vs per-host config)
• Follow-up: the temperature/current-next-event icons are currently baked into ha-bar-module; they should move into bar config (Quickshell widget config here, Waybar format on the default branch)

Validation

• bash -n passes on all modified shell scripts
• bunx tsc --noEmit, bun run build, and bun run format all pass
• qmllint (module-dependent categories disabled) passes on both QML widgets; an intentional syntax error was confirmed to fail
• Bar VM-validated: plugins discovered, parsed values and colours render, hiding works, loading placeholder resolves, dot doctor clean

[timmo001]

@copilot add a github workflow (based on the others in terms of formatting) to validate quickshell files. something like qmllint or similar could work here.

Put it in a dedicated workflow seperate from the dot build workflow, this will be dedicated to quickshell or qml (qt meta language)

[Copilot]

@copilot add a github workflow (based on the others in terms of formatting) to validate quickshell files. something like qmllint or similar could work here.

Put it in a dedicated wo...

Added a dedicated Lint Quickshell workflow (.github/workflows/quickshell-lint.yml) in fa0428e, formatted to match the existing workflows. It installs Qt 6's qmllint and runs it over all *.qml files. Since the Quickshell.* / qs.* modules aren't available in CI, the import/type/property/unqualified/signal categories are disabled so qmllint validates QML syntax and structure (real parse/syntax errors still fail the run). It triggers on *.qml changes (and the workflow file itself), separate from the dot build workflow.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
dotfiles	Ready	Preview, Comment	Jun 27, 2026 9:54am