swaybg(1) General Commands Manual swaybg(1)

# [NAME](#NAME)

swaybg - Background for Wayland

# [SYNOPSIS](#SYNOPSIS)

**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.

# [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.

# [AUTHORS](#AUTHORS)

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>.

2026-08-29

---

Document: swaybg(1) from swaybg 1.2.2-r1 (Chainguard OS)
Source: https://github.com/swaywm/swaybg