Quickshell Rise

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

Theme Picker	Bar Functions & Animations	Unlockbar + Widget Drag/Drop

Install / Remove

Install and start the bar for the current session with V1 initially active:

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

Use V2 instead to start with the V2 interface. Both UI variants are installed as one shell and can be switched later without launching a second Quickshell process.

Install and keep the bar after reboot:

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

Remove the bar and restore your previous config:

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

The installer backs up an existing config to ~/.config/quickshell/bar.bak.<timestamp>.

For requirements, autostart options, and installation details, read Getting started.

Compare V1 and V2

Both interfaces include theme integration, pickers, updates, notifications, AI usage, media controls, system panels, and draggable widget groups.

Area	V1	V2
Layout	Original Rise layout with splits and gap animations	Compact redesign with Full, Fit, Dock, and Notch shells
Workspaces	Default, Numbers, and Magic	Default, Numbers, Magic, Kanji, Frame, and Aurora
Widget styling	Global palette, compact modes, border, frost, and shadow	Global palette plus per-widget fill, border, and contrast controls
Now playing	Default controls or FULL waveform view	Default controls or FULL waveform view
State	Separate V1 layout and style cache	Separate V2 layout and style cache

V2 preview

https://github.com/user-attachments/assets/0e43f091-95d0-4a37-8b65-77a65fd17b74

Click the preview to play the V2 demo.

Documentation

Each guide covers one task and links back to this page.

Guide	Contents
Getting started	Requirements, installation, removal, and autostart
Usage	Widgets, styles, variants, keybindings, and IPC
Maintenance and recovery	Lifecycle, updates, logs, compatibility, and recovery
Development	Repository startup, tests, linting, and releases
Architecture	Variants, controller, state, IPC, and project layout

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 for this project.

License

MIT © 2026 HANCORE-linux