Breadway/breadpaper
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Wallpaper manager for the bread desktop
15 commits 1 branch 15 tags 202 KiB
Find a file
Breadway 168a449edf breadpaper: commit README, align Cargo.toml version with tag 
- README.md existed only in the working tree and was never committed,
  so the published repo/release tarball shipped with no documentation
  at all. Verified its usage/install instructions against the current
  code before committing; corrected the stated Rust requirement from
  1.80+ to 1.85+ (edition 2024 needs 1.85+).
- Cargo.toml: 0.1.0 -> 0.1.10, matching the latest tag (v0.1.10).
  breadpaper --version previously reported nine releases behind the
  actual release history.
2026-07-17 03:20:48 +08:00
.forgejo/workflows fix(ci): clone bread-ecosystem to /tmp to avoid stale permissions 2026-06-17 22:53:08 +08:00
.github/workflows fix: move release workflow to Forgejo, add LICENSE 2026-06-17 14:45:56 +08:00
packaging/arch fix(pkg): move python-pywal to optdepends in PKGBUILD 2026-06-17 14:16:44 +08:00
src fix: rustfmt violations 2026-06-19 08:38:41 +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 breadpaper: commit README, align Cargo.toml version with tag 2026-07-17 03:20:48 +08:00
Cargo.toml breadpaper: commit README, align Cargo.toml version with tag 2026-07-17 03:20:48 +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.