https://github.com/hancore-linux/quickshell-dots
A new journey of customization — Quickshell Rise is my first Quickshell bar, built from scratch for Omarchy. Modern, modular, and fully integrated into the Omarchy ecosystem.
https://github.com/hancore-linux/quickshell-dots
omarchy omarchy-bar omarchy-shell omarchy-theme quickshell quickshell-plugin
Last synced: 2 days ago
JSON representation
A new journey of customization — Quickshell Rise is my first Quickshell bar, built from scratch for Omarchy. Modern, modular, and fully integrated into the Omarchy ecosystem.
- Host: GitHub
- URL: https://github.com/hancore-linux/quickshell-dots
- Owner: HANCORE-linux
- Created: 2026-06-03T20:39:18.000Z (15 days ago)
- Default Branch: main
- Last Pushed: 2026-06-12T17:48:05.000Z (6 days ago)
- Last Synced: 2026-06-12T18:25:38.243Z (6 days ago)
- Topics: omarchy, omarchy-bar, omarchy-shell, omarchy-theme, quickshell, quickshell-plugin
- Language: QML
- Homepage:
- Size: 39.9 MB
- Stars: 17
- Watchers: 0
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Quickshell Rise
My Quickshell bar for Omarchy — my new Rise journey into Quickshell starts here. Enjoy!
[](https://github.com/HANCORE-linux/quickshell-dots)
[](https://github.com/HANCORE-linux/quickshell-dots/network)
[](https://github.com/HANCORE-linux/quickshell-dots/issues)
[](https://buymeacoffee.com/hancore)
Theme Picker
Bar functions & animations
Unlockbar + Widget drag/drop
## Features
| 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) |
| 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 |
| System monitors | CPU · RAM · battery (health · cycles · size · draw ✨) · net · bt |
| Control center | quick toggles · power · Bar Functions fly-out ✨ (widget · workspace · style) |
| Bar style ✨ | border & box-shadow 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
## 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:
```bash
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
```bash
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.` 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](#autostart) once and the bar (with all your
> settings — they persist in `~/.cache/quickshell_*`) is back at every login.
## Usage
### Click bindings
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).
### Keybindings — theme / wallpaper picker on the Omarchy hotkeys (optional)
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`:
```conf
# 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
```
Then `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.conf` for the
> `omarchy-menu theme` / `omarchy-menu background` lines and match whatever
> keys are bound there.
(Also available: `qs -c bar ipc call picker screenshots` and `… videos`.)
### Autostart
Post-boot hook (recommended — brings the bar back at every login)
```bash
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
```
Remove: `rm -f ~/.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:
```bash
curl -fsSL https://raw.githubusercontent.com/HANCORE-linux/quickshell-dots/main/uninstall.sh | bash
```
## Repo structure
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)
```