3.5 KiB
Blob
A self-contained Wayland desktop for Arch Linux.
This started as a layer of overrides on top of Omarchy and is now its own desktop. It keeps the look, layout, and base functionality that were worth keeping, and owns every line that runs. There is no upstream package to track and nothing to re-apply after somebody else's release.
What it is
- Hyprland as the compositor, configured in Lua.
- Quickshell as the desktop:
blob-shellis one process hosting the bar, both menus, the panels, notifications, the lock screen, and the OSD as plugins. - A
blob-*CLI of 251 commands, dispatched byblob. - 24 themes with a palette pipeline that retints the terminal, editor,
browser, shell, and lock screen from one
colors.toml.
Layout
| Path | Contents |
|---|---|
bin/ |
the blob-<area>-<verb> commands |
shell/ |
the Quickshell desktop |
hypr/ |
personal Hyprland config, deployed to ~/.config/hypr |
default/ |
the shipped defaults the commands and shell resolve: hypr/ Lua layer, themed/ templates, blob/ menu tree |
themes/ |
colour themes |
config/ |
shipped app configs |
shell.json |
bar layout and idle timings |
hooks/ |
event hooks, such as retinting on theme change |
branding/ |
icon, ASCII art, boot splash |
wallpapers/ |
103 wallpapers, previewed in the gallery |
session/ |
wayland session entry and uwsm environment |
docs/ |
everything below |
Docs
| Doc | Covers |
|---|---|
| commands.md | every command, generated from its own metadata |
| keybinds.md | every binding, generated from the Lua |
| shell.md | shell layout, bar config, plugin model |
| themes.md | the palette pipeline and how to add a theme |
| widgets.md | the ported GTK widgets and where they went |
| menu.md | the menu tree and what was trimmed |
| upstream.md | the fork base, for diffing later |
Install
BLOB_PATH is a symlink to this checkout, so bin/, shell/, themes/ and
default/ are always the working tree and edits are live. Only the handful of
files that must sit under ~/.config get copied.
./install.sh # link and deploy
./install.sh --check # report what would change, write nothing
./install.sh --force # overwrite files with local changes
Then log out and pick the Blob session.
To back out, ./uninstall.sh removes the session entry, the config, and the
symlink, restoring any .bak the installer made. The checkout, the wallpapers,
and the themes stay where they are.
Regenerating docs
blob-docs-commands
blob-docs-keybinds
Keys worth knowing
| Keys | Action |
|---|---|
Super + Space |
Apps menu |
Super + Alt + Space |
Root menu |
Super + Ctrl + Q |
Quick settings |
Super + Ctrl + M |
System monitor |
Super + Alt + W |
Wallpaper picker |
Super + Ctrl + L |
Lock |
The rest are in keybinds.md, or run blob menu keybindings.