Shibumi Shell

A native bar and plugin suite for Omarchy Quattro

_{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.13 prerelease passed physical single-output acceptance on Omarchy 4.0.3. 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

Install

Important

0.1.1-beta.13 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 --yes

Pacman 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
./scripts/shibumi-suite install --yes

Update the transitional source installation with:

cd Shibumi-Shell
git pull --ff-only
./scripts/shibumi-suite update --yes

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

Uninstall

Remove all managed Shibumi plugins and restore the stock Omarchy bar:

shibumi-shell uninstall --yes && omarchy pkg drop shibumi-shell

For the transitional source installation, run this from its checkout instead:

./scripts/shibumi-suite uninstall --yes

Do 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

Documentation

• 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

Contributing · Changelog · MIT License