swaybg(1)

swaybg1

Background for wayland

Usage

swaybg [options ...]

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.

Releases

4 releases since Debian 11 (Bullseye); the text changed 3 times.

  1. 11
  2. 12
  3. 13
  4. Arch

Authors

Maintained by Simon Ser <[email protected]>, who is assisted by other open source contributors. For more information about swaybg development, see <https://github.com/swaywm/swaybg>.

From swaybg 1.2.2-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.