swaybg - Man Page

• Set the wallpaper on all monitors to an image: swaybg [-i|--image] path/to/image
• Set the image scaling mode (default: stretch): swaybg [-i|--image] path/to/image [-m|--mode] stretch|fit|fill|center|tile|solid_color
• Set the wallpaper to a static color: swaybg [-c|--color] rrggbb
• Set the wallpaper on a specific monitor: swaybg [-o|--output] HDMI-1 [-i|--image] path/to/image
• Set different wallpapers on multiple monitors: swaybg [-o|--output] HDMI-1 [-i|--image] path/to/image [-o|--output] DP-1 [-i|--image] path/to/image

tldr.sh

swaybg [options...]

Displays a background image on all outputs of your Wayland session.

Without an output specified, appearance options apply to all outputs. Per-output appearance options can be set by passing -o, --output followed by these options.

-c,  --color <[#]rrggbb>

Set the background color.

-h,  --help

Show help message and quit.

-i,  --image <path>

Set the background image.

-m,  --mode <mode>

Scaling mode for images: stretch, fill, fit, center, or tile. Default is stretch. Use the additional mode solid_color to display only the background color, even if a background image is specified.

-o,  --output <name>

Select an output to configure. Subsequent appearance options will only apply to this output. The special value * selects all outputs.

-v,  --version

Show the version number and quit.

Maintained by Simon Ser <contact@emersion.fr>, who is assisted by other open source contributors. For more information about swaybg development, see <https://github.com/swaywm/swaybg>.