| 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 |
Install and start the bar for the current session:
curl -fsSL https://raw.githubusercontent.com/HANCORE-linux/quickshell-dots/main/install.sh | bash -s V1Install and keep the bar after reboot:
curl -fsSL https://raw.githubusercontent.com/HANCORE-linux/quickshell-dots/main/install.sh | bash -s V1 --autostartRemove the bar and restore your previous config:
curl -fsSL https://raw.githubusercontent.com/HANCORE-linux/quickshell-dots/main/uninstall.sh | bashThe installer backs up an existing config to ~/.config/quickshell/bar.bak.<timestamp>.
| Area | Highlights |
|---|---|
| Bar layout | unlock mode, widget-group drag/drop, persistent order, top/bottom position |
| Visual style | theme-aware colors, border, shadow, frost, split groups, gap animations |
| Pickers | theme, wallpaper, screenshots, videos, with Tanzaku, Hearthstone, and Carousel styles |
| Widgets | workspaces, audio, battery, CPU, memory, network, Bluetooth, weather, MPRIS, tray, notifications |
| Updates | in-bar shell update badge, Arch/AUR counter, known-infected AUR safety check |
| AI usage | Claude + Codex usage pill with switchable provider and detail panel |
Full feature list
| Module | Function |
|---|---|
| Unlock & reorder | unlock the bar, drag widget-groups to swap positions, persistent |
| Image pickers | theme, wallpaper, screenshots, videos, 3 selectable styles, cached thumbnails |
| Self-update | in-bar badge when a new version ships, one-click update and restart |
| Package updates | system + AUR counter with pre-install security check |
| AI usage | combined Claude + Codex token-usage pill |
| Workspaces | switch, overview, 10 / 5 / active-only modes, dots / numbers / magic styles |
| Weather | current conditions, metric / imperial toggle |
| Clock | time, calendar, 24h / 12h toggle |
| MPRIS | media controls |
| Notifications | mako history, unread count, clear |
| System monitors | CPU, RAM, battery health, network, Bluetooth |
| Speed test | manual Cloudflare speed test in the network panel |
| Control center | quick toggles, power, Bar Functions fly-out |
| Bar style | border, shadow, frost, pill radius, top/bottom position |
| Split groups | positional pill splits + Stream, Surge, Bolt, Bolt 2 gap animations |
| Keybind IPC | qs -c bar ipc call picker theme|wallpaper|screenshots|videos |
| Per-widget panels | click widget to open its popup |
Built for Omarchy / Hyprland. It integrates with omarchy-* helpers, Omarchy theme files, Hyprland, mako, and Omarchy's hook system.
Required packages are checked by the installer:
sudo pacman -S quickshell git jq curl ttf-jetbrains-mono-nerd ttf-material-symbols-variableOptional widget dependencies
Optional packages enable specific widgets:
sudo pacman -S pamixer brightnessctl power-profiles-daemon bluez-utils iwd impala hypridle gpu-screen-recorderNotes:
bluez-utilsprovidesbluetoothctl, which the Bluetooth widget currently uses.voxtypeis optional for the Voxtype widget.- The install script checks required tools and warns about missing optional tools.
This bar is built for classic Omarchy setups where Waybar is the stock bar. The installer stops Waybar so both bars do not overlap.
Omarchy 4 / omarchy-shell note
On Omarchy 4.0 / omarchy-shell, this setup is not tested yet. Omarchy 4 already ships its own Quickshell shell, so running both shells at the same time may create duplicate bars or conflicting keybinds. Use this on Omarchy 4 only if you know how to disable or separate the built-in shell.
Most interactions follow one rule: click a widget to open its panel.
Common actions:
- Double-click an empty bar area to unlock drag/drop mode.
- Press
Escor click the dimmed backdrop to lock again. - Open the launcher/control widget to change bar style, widgets, workspaces, logo, splits, and animations.
- Use the self-update badge when it appears to update the shell from inside the bar.
Click bindings
| Widget | Left | Middle | 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 | - | force refresh | - |
| Voxtype | cycle model | - | config | - |
| Workspace | switch workspace | - | overview | - |
| MPRIS | inline controls | - | toggle panel | - |
| Tray bar widget | toggle tray panel | - | - | - |
| Tray icon | activate | context menu | hide icon | - |
Theme / wallpaper keybinds
Omarchy binds theme and wallpaper menus to these keys by default:
| Action | Key | Omarchy default |
|---|---|---|
| Theme | Super + Shift + Ctrl + Space |
omarchy-menu theme |
| Wallpaper | Super + Ctrl + Space |
omarchy-menu background |
To route those keys to this bar's pickers, add this to ~/.config/hypr/bindings.conf:
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 run:
hyprctl reloadOther picker IPC commands:
qs -c bar ipc call picker screenshots
qs -c bar ipc call picker videosManual autostart hook
If you did not install with --autostart, add the Omarchy post-boot hook manually:
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 only the hook:
rm -f ~/.config/omarchy/hooks/post-boot.d/quickshell-riseThe bar checks for shell updates and shows an update badge when this repo has a newer version.
Shell updates and Arch/AUR safety checks
Click the shell update badge to review changes and apply the update.
Package updates run through the ArchUpdater panel. It checks packages against the known-infected AUR list and blocks known-bad packages from the update command.
Project layout
Each folder under versions/ is a complete, self-contained bar.
versions/V1/
├── shell.qml # entry point
├── BarSlot.qml # slot-based bar
├── Theme.qml # colors, state, flags
├── Palette.js # reads Omarchy colors.toml
├── IconMap.js # icon name to codepoint
├── assets/ # bundled logo assets
├── modules/ # bar widgets
└── panels/ # popups and overlays
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 for this project.
MIT © 2026 HANCORE-linux