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

0.1.1-beta.16.1 is published as a GitHub prerelease. AUR publication is deferred; use the source installation below. See the release notes for changes and the downgrade warning. The current pinned host contracts use Omarchy and Omarchy Settings 4.0.4-1 (source tag v4.0.4, revision c668141e) with Quickshell 0.3.1-1; the 4.0.3 and 4.0.2 manifests remain optional compatibility baselines. Multi-output acceptance was not run. See the Shibumi host compatibility record for the latest validated host versions.

Quick	Configure
Bars	Plugins

Install

Important

AUR publication is deferred; use the source installation below. Install from the release tag, not main. 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.

Install from source using the release tag:

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

Update an admitted Beta.16 source installation to Beta.16.1. Exact predecessor identities, not a version range, govern admission; see the update guide.

cd Shibumi-Shell
git fetch --tags
git checkout v0.1.1-beta.16.1
./scripts/shibumi-suite update --dry-run
./scripts/shibumi-suite update --yes
./scripts/shibumi-suite status

Do 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.

The source installation 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 a 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