| 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 with V1 initially active:
curl -fsSL https://raw.githubusercontent.com/HANCORE-linux/quickshell-dots/main/install.sh | bash -s V1Use 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 --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>.
For requirements, autostart options, and installation details, read Getting started.
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.mp4
Click the preview to play the V2 demo.
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 |
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