Breadway/breadpaper
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Wallpaper manager for the bread desktop
17 commits 1 branch 15 tags 202 KiB
Find a file
Exact
Breadway c20a6d966c
Some checks failed
Mirror to GitHub / mirror (push) Failing after 2s
Details
Build and publish package / package (push) Failing after 27s
Details
release / build (push) Successful in 11s
Details
Switch to tag-pinned bread-ecosystem deps; bump version to v0.1.11
2026-07-19 03:52:49 +08:00
.forgejo/workflows fix(ci): clone bread-ecosystem to /tmp to avoid stale permissions 2026-06-17 22:53:08 +08:00
packaging/arch Switch to tag-pinned bread-ecosystem deps; bump version to v0.1.11 2026-07-19 03:52:49 +08:00
src Timeout-guard subprocess calls to awww, wal, and bread-theme 2026-07-17 09:52:40 +08:00
.gitignore Initial implementation of breadpaper 2026-06-17 14:05:48 +08:00
bakery.toml Initial implementation of breadpaper 2026-06-17 14:05:48 +08:00
Cargo.lock Switch to tag-pinned bread-ecosystem deps; bump version to v0.1.11 2026-07-19 03:52:49 +08:00
Cargo.toml Switch to tag-pinned bread-ecosystem deps; bump version to v0.1.11 2026-07-19 03:52:49 +08:00
LICENSE fix: move release workflow to Forgejo, add LICENSE 2026-06-17 14:45:56 +08:00
README.md breadpaper: commit README, align Cargo.toml version with tag 2026-07-17 03:20:48 +08:00

README.md

breadpaper

Wallpaper manager for the bread desktop. Sets a wallpaper via awww, generates a colour palette with pywal, and reloads bread themes in one command.

Dependencies

Runtime:

  • awww — Wayland wallpaper daemon
  • python-pywal — colour palette generation
  • bread-theme — theme reload (part of the bread ecosystem)

Build:

  • Rust 1.85+ (edition 2024) / cargo

Install

From the bakery (recommended on bread OS):

bakery install breadpaper

From source:

cargo build --release
install -Dm755 target/release/breadpaper ~/.local/bin/breadpaper

Arch Linux (PKGBUILD):

cd packaging/arch
makepkg -si

Usage

breadpaper <path>          # set wallpaper (shorthand for `set`)
breadpaper set <path>      # set wallpaper, generate palette, reload themes
breadpaper get             # print the current wallpaper path

Supported formats: png, jpg, jpeg, webp, gif, bmp.

The current wallpaper path is stored by pywal at ~/.cache/wal/wal.

License

MIT — see LICENSE.