-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
18 additions
and
42 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,61 +1,37 @@ | ||
| # rwpspread | ||
| swaybg-spread | ||
| ============= | ||
|
|
||
| [](https://github.com/0xk1f0/rwpspread/actions/workflows/rust.yml) | ||
|  | ||
| A CLI tool to set a wallpaper spanning over multiple monitors in sway. | ||
|
|
||
| Wallpaper Utility written in Rust | ||
| It uses the Wayland output configuration to determine monitor size and position, and splits the provided image into separate images for each monitor. These are saved to `~/.cache` by default. It then uses `swaybg` to set the images on the corresponding monitors. To persist the changes the program outputs sway configuration lines which can be written to a sway configuration file. | ||
|
|
||
| ## Features | ||
|
|
||
| - Spans an input wallpaper across all monitors | ||
| - Works alongside any wlroots based compositor f.E. [Hyprland](https://hyprland.org/) | ||
| - Uses [wpaperd](https://github.com/danyspin97/wpaperd) as wallpaper daemon | ||
| - Code quality is probably pretty poor as I'm new to Rust | ||
|
|
||
| ## Installing | ||
| Originally forked off of [0xk1f0/rwpspread](https://github.com/0xk1f0/rwpspread) | ||
|
|
||
| On Archlinux via the [AUR](https://aur.archlinux.org/) | ||
|
|
||
| ```bash | ||
| paru -S rwpspread-git | ||
| ``` | ||
| Usage | ||
| ----- | ||
|
|
||
| ## Building | ||
| Set wallpaper and write it to a sway configuration file to persist sway reloads (The file is imported in the main sway configuration file with `include ~/.config/sway/config.d/*`): | ||
|
|
||
| ```bash | ||
| git clone https://github.com/0xk1f0/rwpspread.git | ||
| cd rwpspread/ | ||
| cargo build --release | ||
| swaybg-spread -i ~/.theme/active/wallpaper.jpg > ~/.config/sway/config.d/bg.conf | ||
| ``` | ||
|
|
||
| ## Usage | ||
| Use custom location for saving image fragments: | ||
|
|
||
| ```bash | ||
| # it takes an input image | ||
| # screens are automatically read | ||
| # if running a wlroots based compositor | ||
| rwpspread -i <image> | ||
| swaybg-spread -i ~/.theme/active/wallpaper.jpg -o ~/.theme/fragments > ~/.config/sway/config.d/bg.conf | ||
| ``` | ||
|
|
||
| # for example | ||
| rwpspread -i /some/path/wallpaper.png | ||
|
|
||
| # to use the wpaperd integration | ||
| # this autogenerates the config file | ||
| # you will need to have wpaperd installed | ||
| rwpspread -w -i /some/path/wallpaper.png | ||
| Building | ||
| -------- | ||
|
|
||
| # for more info | ||
| rwpspread --help | ||
| ```bash | ||
| git clone https://github.com/fyodordev/swaybg-spread.git | ||
| cd swaybg-spread | ||
| cargo build --release | ||
| ``` | ||
|
|
||
| ## Checklist | ||
|
|
||
| - [x] splitting for dual screen layout | ||
| - [x] splitting for any screen layout (two or more screens) | ||
| - [x] Hyprland/wlroots Integration | ||
| - [x] wpaperd Integration | ||
| - [x] wallpaper caching (don't resplit if we don't need to) | ||
| - [ ] color palette generation from wallpaper | ||
| - [ ] watchdog auto-resplit on output change | ||
| - [ ] alignment adjust if wallpaper is big enough | ||
| - [ ] monitor bezel compensation |