OS Manuals

/usr/bin/swaybg

Wallpaper tool for wlroots-based and other Wayland compositors

From swaybg 1.2.2-r4 (enterprise-packages), captured 2026-11-08 by running swaybg --help (exit 0). permalink

Usage: swaybg <options...>

  -c, --color RRGGBB     Set the background color.
  -h, --help             Show help message and quit.
  -i, --image <path>     Set the image to display.
  -m, --mode <mode>      Set the mode to use for the image.
  -o, --output <name>    Set the output to operate on or * for all.
  -v, --version          Show the version number and quit.

Background Modes:
  stretch, fit, fill, center, tile, or solid_color
Options (6)
OptionDescriptionSource
-c, --color RRGGBBSet the background color.help + man
-h, --helpShow help message and quit.help + man
-i, --image pathSet the image to display.help + man
-m, --mode modeScaling mode for images: stretch, fill, fit, center, or tile.help + man
-o, --output nameSet the output to operate on or * for all.help + man
-v, --versionShow the version number and quit.help + man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.