Shibumi brings the approved QS Rise V1 and V2 layouts, controls, widgets, panels, and interaction model into Omarchy's existing shell process.
Get started · Documentation · Release status
The published 0.1.1-beta.15.1 prerelease was validated on a single-output
Omarchy 4.0.3 host; see the release notes for scope and known limits.
The current pinned host contracts use Omarchy
and Omarchy Settings 4.0.3-1 (source tag v4.0.3, revision 05349870) with
Quickshell 0.3.1-1; the 4.0.2 manifests remain an optional compatibility
baseline. Multi-output acceptance was not run. See the
Shibumi host compatibility record
for the latest validated host versions.
Quick
|
Configure
|
Bars
|
Plugins
|
Important
0.1.1-beta.15.1 is published as a GitHub prerelease, but AUR publication is
deferred and the package is not available from AUR yet. Until the AUR package
is published, use the source path below. Shibumi supports Omarchy Quattro
only.
After AUR publication, the supported one-command installation is:
omarchy pkg aur add shibumi-shell && shibumi-shell install --yesPacman resolves the required runtime packages and skips dependencies already provided by the system. The explicit Shibumi command then stages and verifies the 24 user plugins without a root package hook touching the user's config.
Until the AUR package is released, use this transitional source installation:
sudo pacman -S --needed python jq curl networkmanager power-profiles-daemon upower xdg-utils libnotify wl-clipboard ttf-material-symbols-variable ttf-jetbrains-mono-nerd-basic noto-fonts-cjk adwaita-fonts
git clone https://github.com/HANCORE-linux/Shibumi-Shell.git
cd Shibumi-Shell
git checkout v0.1.1-beta.15.1
./scripts/shibumi-suite install --yesUpdate the transitional source installation from an earlier tag (supported predecessors: tags v0.1.1-beta.11 through v0.1.1-beta.15):
cd Shibumi-Shell
git fetch --tags
git checkout v0.1.1-beta.15.1
./scripts/shibumi-suite update --yesDo not install or update from main. If you previously installed from main, run ./scripts/shibumi-suite uninstall --keep-settings --yes from that exact checkout before switching to a tag.
This transitional source command asks for root privileges only while Pacman installs missing runtime commands and fonts. The Shibumi lifecycle itself runs as the desktop user and writes only user-scoped plugin state.
Installation, updates, recovery, and removal
Remove all managed Shibumi plugins and restore the stock Omarchy bar:
shibumi-shell uninstall --yes && omarchy pkg drop shibumi-shellFor the transitional source installation, run this from its checkout instead:
./scripts/shibumi-suite uninstall --yesDo not run omarchy pkg drop shibumi-shell after a source uninstall: that
workflow did not install a shibumi-shell package. Pacman-managed runtime
dependencies remain installed because they may be shared with other software.
Uninstall options and settings preservation
- Get started
- Install, update, repair, or remove Shibumi
- Configure the shell
- Explore the plugin catalog
- Use Shibumi plugins with other bars
- Troubleshoot a problem
- Understand the architecture
- Check Omarchy Quattro compatibility
- Review current release readiness
- Browse all documentation
- Credit: Lacuna Shell by @OldJobobo provided structural inspiration for the Omarchy Quattro plugin-suite layout
