Quickshell Rise

My Quickshell bar for Omarchy — my new Rise journey into Quickshell starts here. Enjoy!

Features

✨ = new in v2.x

Requirements

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-variable

Optional per widget: pamixer, brightnessctl, power-profiles-daemon, bluez, iwd + impala, hypridle, gpu-screen-recorder, voxtype.

Install

curl -fsSL https://raw.githubusercontent.com/HANCORE-linux/quickshell-dots/main/install.sh | bash -s V1

The 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.

Usage

Click bindings

Keybindings — theme / wallpaper picker on the Omarchy hotkeys (optional)

# 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 wallpaper

Autostart

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-rise

Updating

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.

Uninstall

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 | bash

Repo structure

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)

Credits

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.

License

MIT © 2026 HANCORE-linux