8d8be6ebb1
Two monitors can keep different wallpapers. `set --output` targets one awww output, writes that output's bread-theme files, and updates ~/.config/breadpaper/current.json without clobbering the other. Global set still runs wal + bread-theme reload and stamps every known output. `apply` and listen-on-monitor-connect restore the saved map. The library picker binds to its monitor and applies to that output.
89 lines
2.8 KiB
Markdown
89 lines
2.8 KiB
Markdown
# breadpaper
|
|
|
|
Wallpaper setter for the bread desktop. One command sets the wallpaper
|
|
via [awww](https://github.com/heywoodlh/awww), generates a palette with
|
|
[pywal](https://github.com/dylanaraps/pywal) (`wal`), and runs
|
|
`bread-theme reload`. Two monitors can keep different wallpapers (and
|
|
per-output bread-theme files); the last path per output is stored in
|
|
`~/.config/breadpaper/current.json`.
|
|
|
|
`set` / `get` / `apply` stay one-shot CLI. `breadpaper library` (alias
|
|
`browse`) opens a GTK picker over the wallpaper directories. It is not
|
|
a slideshow daemon.
|
|
|
|
## 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`)
|
|
|
|
`library` also needs GTK4 (the window loads `bread-theme`'s shared
|
|
stylesheet and follows the monitor it sits on). `get` without
|
|
`--output` still reads the path pywal stored at `~/.cache/wal/wal`.
|
|
`get --output NAME` reads `~/.config/breadpaper/current.json`.
|
|
|
|
## Install
|
|
|
|
```
|
|
bakery install breadpaper
|
|
```
|
|
|
|
From source:
|
|
|
|
```
|
|
cargo build --release
|
|
install -Dm755 target/release/breadpaper ~/.local/bin/breadpaper
|
|
```
|
|
|
|
## Usage
|
|
|
|
```
|
|
breadpaper <path> # shorthand for `set` (all outputs)
|
|
breadpaper <path> --output NAME # one output
|
|
breadpaper set <path> # awww + wal + bread-theme reload (all)
|
|
breadpaper set <path> --output NAME
|
|
breadpaper get # print ~/.cache/wal/wal
|
|
breadpaper get --output NAME # path from current.json
|
|
breadpaper apply # restore current.json
|
|
breadpaper library # GTK picker (alias: browse)
|
|
breadpaper library --dir PATH # also scan PATH (repeatable)
|
|
breadpaper listen # honor bread.command.paper.set / .library
|
|
```
|
|
|
|
Supported formats: `png`, `jpg`, `jpeg`, `webp`, `gif`, `bmp`.
|
|
|
|
## Library
|
|
|
|
`breadpaper library` scans these directories (missing ones are skipped):
|
|
|
|
1. `~/Pictures/Wallpapers`
|
|
2. `/usr/share/backgrounds/bos`
|
|
|
|
Override the list in `~/.config/breadpaper/config.toml`:
|
|
|
|
```toml
|
|
library_dirs = [
|
|
"~/Pictures/Wallpapers",
|
|
"/usr/share/backgrounds/bos",
|
|
]
|
|
```
|
|
|
|
`BREADPAPER_LIBRARY_DIRS` (colon-separated) overrides the file. `--dir`
|
|
appends extra roots for that invocation. Clicking a thumbnail applies
|
|
to the monitor the picker is on (`set --output`); if the output cannot
|
|
be resolved it falls back to all outputs.
|
|
|
|
## Bread events
|
|
|
|
After a successful `set`, breadpaper emits `bread.paper.changed` if
|
|
`breadd` is running (silent no-op if it isn't). `breadpaper listen` is
|
|
the optional long-running subscriber for `bread.command.paper.set` and
|
|
`bread.command.paper.library`; it does not start by itself. Lua modules
|
|
can still `bread.exec("breadpaper set …")` or
|
|
`bread.exec("breadpaper library")`. See [EVENTS.md](EVENTS.md).
|
|
|
|
## License
|
|
|
|
MIT — see [LICENSE](LICENSE).
|