breadpaper/README.md
Breadway 70c2dd3c6a
All checks were successful
check / check (push) Successful in 8s
bakery.toml: bread-theme + awww/pywal, not bread
The setter shells out to awww, wal, and bread-theme reload. It never
talks to breadd. bakery.toml listed bread as a dep and treated awww as
optional.

Add a short README: this is a setter, not a library or slideshow
daemon. Wallpaper library UI lives in bos-settings.
2026-08-15 21:34:55 +08:00

1.1 KiB

breadpaper

Wallpaper setter for the bread desktop. One command sets the wallpaper via awww, generates a palette with pywal (wal), and runs bread-theme reload.

It is not a wallpaper library, a slideshow daemon, or a GUI. Browsing ~/Pictures/Backgrounds and picking an image lives in bos-settings.

Dependencies

Must be on $PATH for set:

  • awww — Wayland wallpaper (awww img)
  • wal — palette generation (python-pywal)
  • bread-theme — theme reload (bakery package, not breadd)

get only reads the path pywal stored at ~/.cache/wal/wal.

Install

bakery install breadpaper

From source:

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

Usage

breadpaper <path>          # shorthand for `set`
breadpaper set <path>      # awww + wal + bread-theme reload
breadpaper get             # print the current wallpaper path

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

License

MIT — see LICENSE.