pogmommy/multibg-wayland
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Set a different wallpaper for the background of each Sway workspace - packaged for debian
52 commits 1 branch 0 tags 276 KiB
Find a file
Gergő Sályi 1f253ac3f9 Formatting only - apply added editorconfig to all files
2024-09-30 20:29:09 +02:00
src Formatting only - apply added editorconfig to all files 2024-09-30 20:29:09 +02:00
.editorconfig Add .editorconfig based on the Rust language repository 2024-09-30 20:19:42 +02:00
.gitignore Initial commit 2023-04-07 17:25:48 +02:00
.gitmodules Update dependencies, rm fast_image_resize submod. 2023-05-05 08:26:41 +02:00
Cargo.lock Update dependencies, fix incompatibilities 2024-09-30 19:54:21 +02:00
Cargo.toml Update dependencies, fix incompatibilities 2024-09-30 19:54:21 +02:00
CHANGELOG.md Prepare release 0.1.7 2024-05-11 01:12:06 +02:00
LICENSE-APACHE Formatting only - apply added editorconfig to all files 2024-09-30 20:29:09 +02:00
LICENSE-MIT Formatting only - apply added editorconfig to all files 2024-09-30 20:29:09 +02:00
PKGBUILD Update PKGBUILD to 0.1.7 release 2024-05-11 01:22:47 +02:00
README.md Fixup readme 2023-08-31 18:42:50 +02:00

README.md

multibg-sway

Set a different wallpaper for the background of each Sway workspace

Usage

$ multibg-sway <WALLPAPER_DIR>

Wallpapers should be arranged in the following directory structure:

wallpaper_dir/output/workspace_name.{jpg|png|...}

Eg.

~/my_wallpapers/HDMI-A-1/1.jpg

In more detail:

  • wallpaper_dir: A directory, this will be the argument for the multibg-sway command

  • output: A directory with the same name as a sway output eg. eDP-1, HDMI-A-1

    • If one has multiple outputs with the same resolution this can be a symlink to the directory of the other output.

    • To get the name of current outputs from sway one may run:

      $ swaymsg -t get_outputs

  • workspace_name: The name of the sway workspace, by sway defaults: 1, 2, 3, ..., 10

    • Can be a manually defined workspace name (eg. in sway config), but renaming workspaces while multibg-sway is running is not supported currently
    • Can define a fallback wallpaper with the special name: _default
    • Can be a symlink to use a wallpaper image for multiple workspaces

Wallpaper images are now automatically resized at startup to fill the output. Still it is better to have wallpaper images the same resolution as the output, which automatically avoids resizing operations and decreases startup time.

Example

For one having a laptop with a built-in display eDP-1 and an external monitor HDMI-A-1, wallpapers can be arranged such as:

~/my_wallpapers
    ├─ eDP-1
    │    ├─ _default.jpg
    │    ├─ 1.jpg
    │    ├─ 2.png
    │    └─ browser.jpg
    └─ HDMI-A-1
         ├─ 1.jpg
         └─ 3.png

Then start multibg_sway:

$ multibg-sway ~/my_wallpapers

It is recommended to edit the wallpaper images in a dedicated image editor. Nevertheless the contrast and brightness might be adjusted here:

$ multibg-sway --contrast=-25 --brightness=-60 ~/my_wallpapers

In case of errors multibg-sway logs to stderr and tries to continue. One may wish to redirect stderr if multibg-sway is being run as a daemon.

Resource usage

Loaded wallpapers are stored uncompressed to enable fast wallpaper switching with nearly zero CPU use. For example for 10 full HD wallpaper this means 10*1920*1080*4 = 83 MB graphics memory use.

Because multibg-sway doesn't have its own GPU context and manages graphics memory through sway, all this usage might be reported as additional memory used by the sway process.

Installation

Alternatives