---
name: "swaybg"
section: "1"
platform: "linux"
package: "swaybg"
version: "1.2.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/swaybg"
---

# swaybg(1)

Background for Wayland

## NAME

swaybg - Background for Wayland

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

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

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