53756e840a
- breadbox/Cargo.toml: depend on bread-theme with gtk feature
- breadbox/src/main.rs: remove local Palette + hex_to_rgba; use
bread_theme::{load_palette, hex_to_rgba, gtk::apply_user_css}
- bakery.toml: describes breadbox for bakery install
- release.yml: builds on hestia self-hosted runner, publishes binaries to
dl.breadway.dev and GitHub Releases on v* tags
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
|
||
|---|---|---|
| .github/workflows | ||
| breadbox | ||
| breadbox-shared | ||
| breadbox-sync | ||
| packaging | ||
| .gitignore | ||
| bakery.toml | ||
| Cargo.lock | ||
| Cargo.toml | ||
| config.example.toml | ||
| LICENSE | ||
| README.md | ||
breadbox
A GTK4 app launcher for Hyprland / Wayland on Arch Linux.
breadbox-shared shared types (DesktopEntry, IconCache, Config)
breadbox-sync standalone icon resolution + caching binary
breadbox GTK4 layer-shell launcher
Features
- Layer-shell window, centered 600 px wide, keyboard-exclusive
- Reads the active Hyprland workspace and sorts apps by context priority
- Fuzzy filtering as you type; Enter launches, Escape closes
- App icons loaded from the resolved icon cache (see
breadbox-sync) - pywal palette auto-detected from
~/.cache/wal/colors.json, falls back to Catppuccin Mocha - User CSS override at
~/.config/breadbox/style.css - Toggle/dismiss: running a second instance kills the first
Build dependencies
gtk4 (pacman -S gtk4)
gtk4-layer-shell (pacman -S gtk4-layer-shell)
librsvg (pacman -S librsvg) # for SVG icon support
rust (stable) (rustup toolchain install stable)
Build
# debug
cargo build
# release (recommended — put both binaries on $PATH)
cargo build --release
# binaries are at target/release/breadbox and target/release/breadbox-sync
Install to ~/.cargo/bin (or anywhere on your PATH):
cargo install --path breadbox
cargo install --path breadbox-sync
Configuration
Copy and edit the example config:
mkdir -p ~/.config/breadbox
cp config.example.toml ~/.config/breadbox/config.toml
The [[context]] blocks map Hyprland workspace names to app priority lists.
Workspace name "default" is the catch-all fallback.
[[context]]
name = "default"
priority = ["firefox", "code", "obsidian", "kitty"]
[[context]]
name = "2"
priority = ["slack", "discord"]
CSS theming
breadbox applies pywal colors automatically when ~/.cache/wal/colors.json is
present. To override or extend the theme:
~/.config/breadbox/style.css
This file is loaded at the highest CSS priority level, so any rule here wins.
Icon sync
breadbox-sync resolves icons for all installed apps and writes them to
~/.cache/breadbox/. Run it once before first launch:
breadbox-sync
Icon resolution order:
- System icon theme (
~/.local/share/icons,/usr/share/icons,/usr/share/pixmaps) — 64 px > 48 px PNG, then SVG - Flathub media server — for reverse-DNS app IDs (e.g.
org.gnome.Gedit) - icon.horse — downloaded and cached
application-x-executablefallback from system theme
Systemd service (run on login)
cp packaging/breadbox-sync.service ~/.config/systemd/user/
systemctl --user enable --now breadbox-sync.service
The service runs breadbox-sync once at login (after network is up) and logs
to journald. Re-run manually after installing new apps:
systemctl --user start breadbox-sync.service
# or just:
breadbox-sync
Hyprland keybind
Add to ~/.config/hypr/hyprland.conf:
bind = $mainMod, SPACE, exec, breadbox
Pressing the keybind again while the launcher is open dismisses it.
Licence
MIT — see LICENSE.