| Theme Picker | Bar functions & animations | Unlockbar + Widget drag/drop |
screenrecording-2026-06-10_15-31-34-web.mp4 |
screenrecording-2026-06-10_15-39-50.mp4 |
screenrecording-2026-06-11_16-14-45.mp4 |
| Module | Function |
|---|---|
| Unlock & reorder ✨ | unlock the bar → drag whole widget-groups to swap positions · persistent |
| Image pickers ✨ | theme · wallpaper · screenshots · videos — 3 selectable styles: Tanzaku · Hearthstone · Carousel (cached thumbnails + instant reopen) |
| Self-update ✨ | in-bar badge when a new version ships → one-click update & restart |
| Package updates ✨ | system + AUR counter with a pre-install security check against the known-infected AUR list (auto-refreshed weekly) |
| AI usage ✨ | combined Claude + Codex token-usage pill — switch provider · tooltip + panel show both |
| Workspaces | switch · overview · persist 10 / 5 / active-only ✨ · dots / numbers / magic styles ✨ |
| Weather | current conditions · °C / °F (imperial/metric) toggle ✨ |
| Clock | time · calendar · 24h / 12h toggle ✨ |
| Mpris | media controls |
| Notifications | notification center — mako popups + history · unread count · clear |
| System monitors | CPU · RAM · battery (health · cycles · size · draw ✨) · net · bt |
| Speed test ✨ | manual Cloudflare connection test in the network panel — edge · ping · download · upload · zero-install (no extra packages) |
| Control center | quick toggles · power · Bar Functions fly-out ✨ (widget · workspace · style) |
| Bar style ✨ | border, box-shadow & frost toggles (independent) · pill radius 12 / 6 · bar on top or bottom · theme-aware border tone |
| Split groups ✨ | positional pill splits + gap animations (Stream · Surge · Bolt · Bolt 2) |
| Keybind IPC ✨ | qs -c bar ipc call picker theme|wallpaper|screenshots|videos |
| Per-widget panels | click widget → popup |
✨ = new in v2.x
Built for Omarchy / Hyprland — not for plain setups without Omarchy. The bar
integrates the omarchy-* helpers (wifi/bluetooth/audio launchers, update,
screen recorder, voxtype) and follows the active Omarchy theme.
Omarchy version: built for classic Omarchy (Waybar-based, ~3.8.x), where the menu keybinds call
omarchy-menu. On Omarchy 4.0.0 (the Quickshell-based omarchy-shell) you'd disable the built-in shell bar to avoid running two bars, and the theme/wallpaper/menu/launcher are invoked differently — adjust the keybinds you pull from here accordingly.
Comes with Omarchy: Hyprland, the omarchy-* helpers, fonts (JetBrainsMono
Nerd Font + Material Symbols Rounded), mako. Extra:
sudo pacman -S quickshell git jq curl ttf-jetbrains-mono-nerd ttf-material-symbols-variableOptional per widget: pamixer, brightnessctl, power-profiles-daemon,
bluez, iwd + impala, hypridle, gpu-screen-recorder, voxtype.
curl -fsSL https://raw.githubusercontent.com/HANCORE-linux/quickshell-dots/main/install.sh | bash -s V1The bar launches immediately so you can try it. Your previous config is backed
up to ~/.config/quickshell/bar.bak.<timestamp> automatically (older backups
are kept).
Keep it across reboots: the install starts the bar for the current session only — after a reboot Omarchy brings back its stock Waybar. Add the post-boot hook from Autostart once and the bar (with all your settings — they persist in
~/.cache/quickshell_*) is back at every login.
Details
Default: left-click opens the widget panel. Exceptions:
| Widget | Left | Mid | Right | Scroll |
|---|---|---|---|---|
| Audio | panel | — | mute toggle | ±volume |
| Brightness | panel | — | — | ±brightness |
| Clock | toggle 24h / 12h | — | timezone picker | — |
| Power Profile | panel | — | cycle profile | — |
| Network / Bluetooth | panel | — | open system manager | — |
| Weather | panel (Refresh ⁄ °C↔°F) | — | force refresh | — |
| Voxtype | cycle model | — | config | — |
| Workspace | click dot: switch | — | overview | — |
| Mpris | ‹ play › buttons inline | — | toggle panel | — |
| Tray (bar) | toggle tray panel | — | — | — |
| Tray icon | activate | context menu | hide icon | — |
Double-click an empty bar area → unlock & drag widget-groups to reorder
(Esc / click the dimmed backdrop to lock).
Details
Omarchy binds its theme/wallpaper menus (shown via walker) to:
| Action | Key | Omarchy default |
|---|---|---|
| Theme | Super+Shift+Ctrl+Space |
omarchy-menu theme |
| Wallpaper | Super+Ctrl+Space |
omarchy-menu background |
To make those keys open the bar's own pickers instead (and unbind walker for
them), add this to your own ~/.config/hypr/bindings.conf — Omarchy
sources it after its defaults, so it survives omarchy update:
# quickshell-dots: route the theme/wallpaper hotkeys to the bar's pickers
unbind = SUPER SHIFT CTRL, SPACE
unbind = SUPER CTRL, SPACE
bindd = SUPER SHIFT CTRL, SPACE, Theme picker, exec, qs -c bar ipc call picker theme
bindd = SUPER CTRL, SPACE, Wallpaper picker, exec, qs -c bar ipc call picker wallpaperThen hyprctl reload. The unbind lines stop walker's menu from also firing
on those keys; delete the block to restore the Omarchy default. Walker stays
your launcher everywhere else — only these two keys change.
Different Omarchy version? Check
~/.local/share/omarchy/default/hypr/bindings/utilities.conffor theomarchy-menu theme/omarchy-menu backgroundlines and match whatever keys are bound there.
(Also available: qs -c bar ipc call picker screenshots and … videos.)
Post-boot hook (recommended — brings the bar back at every login)
mkdir -p ~/.config/omarchy/hooks/post-boot.d
curl -fsSL -o ~/.config/omarchy/hooks/post-boot.d/quickshell-rise \
https://raw.githubusercontent.com/HANCORE-linux/quickshell-dots/main/contrib/post-boot.d/quickshell-rise
chmod +x ~/.config/omarchy/hooks/post-boot.d/quickshell-riseRemove: rm -f ~/.config/omarchy/hooks/post-boot.d/quickshell-rise
The bar keeps itself current: an update badge appears in the bar when a new version is released — click it to review the changes and apply with one click.
Package updates run through the ArchUpdater panel with a per-package verdict (OK · review · blocked) checked against the known-infected AUR list, which a weekly timer keeps up to date. Blocked packages are excluded from the update command automatically.
One command (works for any installed version) — stops the bar, removes the theme hook, post-boot hook and timers, and brings back your previous config from the backup:
curl -fsSL https://raw.githubusercontent.com/HANCORE-linux/quickshell-dots/main/uninstall.sh | bashDetails
Each folder under versions/ is a complete, self-contained bar.
versions/V1/
├── shell.qml # entry point
├── Bar.qml # layout + dynamic split pills
├── Theme.qml # colors, state, flags
├── Palette.js # reads Omarchy colors.toml
├── IconMap.js # icon name → codepoint
├── assets/ # logo
├── modules/ # bar widgets (*Widget.qml)
└── panels/ # popups (*Panel.qml, TooltipOverlay)
Parts of this project are adapted from Omarchy Shell and modified to integrate with Quickshell Rise. This includes the Carousel picker and selected widget functionality.
The Tanzaku and Hearthstone pickers are original implementations created specifically for this project.
MIT © 2026 HANCORE-linux