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.3 is the target GitHub prerelease. 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

Install from the release tag, not main. Shibumi supports Omarchy Quattro only.

git clone https://github.com/HANCORE-linux/Shibumi-Shell.git
cd Shibumi-Shell
git checkout v0.1.1-beta.16.3
./scripts/shibumi-suite install --yes

The installer 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.

Update an admitted Beta.16.2 source installation to Beta.16.3. 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.3
./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.

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