swaybg

Set wallpaper

$ swaybg -i [wallpaper.jpg]

$ swaybg -o [HDMI-A-1] -i [wallpaper.jpg]

$ swaybg -i [wallpaper.jpg] -m fill

$ swaybg -i [wallpaper.jpg] -m tile

$ swaybg -c "[#1a1a2e]"

$ swaybg -i [wallpaper.jpg] -m center

swaybg [-o output] [-i image] [-m mode] [-c color]

swaybg sets desktop wallpapers for Sway and other wlroots-based Wayland compositors. It supports displaying image files with various scaling modes (stretch, fill, fit, center, tile) or setting a solid background color using hex codes.
Different wallpapers can be assigned to individual outputs by specifying the output name, enabling per-monitor backgrounds in multi-display setups. The tool runs as a persistent background process; to change the wallpaper, the running instance must be killed and a new one started with the desired settings.
Swaybg is typically launched from the Sway configuration file using an `exec` directive, ensuring the wallpaper is set automatically when the compositor starts.

-i, --image FILE

Wallpaper image.

Target output.

Scaling mode.

Background color.

stretch - Stretch to fill
fill - Fill, crop excess
fit - Fit, may letterbox
center - Center, no scaling
tile - Tile image

Wayland only. Sway/wlroots compositors. One instance per wallpaper.

swaybg is part of the Sway project, a Wayland compositor. It provides simple background management for wlroots-based compositors.

sway(1), swaylock(1), feh(1)