Details
- Omarchy-based. Integrates the
omarchy-*helpers (wifi/bluetooth/audio launchers, update, screen recorder, voxtype) and reads the active Omarchy theme. - Built for Omarchy / Hyprland — not for plain setups without Omarchy.
- 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.
Details
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.
Details
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)
Details
One command (works for any installed version) — stops the bar, removes theme hook and post-boot hook, and brings back your previous config from the backup:
curl -fsSL https://raw.githubusercontent.com/HANCORE-linux/quickshell-dots/main/uninstall.sh | bashEvery install also backs up the old config to ~/.config/quickshell/bar.bak.<timestamp> (older backups are kept).
Post-boot hook (opt-in)
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
| 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 |
Details
| 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) |
| Workspaces | switch · overview · persist 10 / 5 / active-only ✨ |
| Weather | current conditions · °C / °F (imperial/metric) toggle ✨ |
| Clock | time · calendar · 24h / 12h toggle ✨ |
| Mpris | media controls |
| System monitors | CPU · RAM · battery (health · cycles · size · draw ✨) · net · bt |
| Control center | quick toggles · power · widget toggles ✨ · workspace mode ✨ · picker style ✨ |
| Keybind IPC ✨ | qs -c bar ipc call picker theme|wallpaper|screenshots|videos |
| Split groups ✨ | positional pill splits + gap animations (Stream · Surge · Bolt · Bolt 2) |
| Per-widget panels | click widget → popup |
✨ = new in v2.0.0 – v2.1.0
curl -fsSL https://raw.githubusercontent.com/HANCORE-linux/quickshell-dots/main/install.sh | bash -s V1The bar launches immediately so you can try it.
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.)