1swaybg(1) General Commands Manual swaybg(1)
2
3
4
6 swaybg - Background for Wayland
7
9 swaybg [options...]
10
11 Displays a background image on all outputs of your Wayland session.
12
13 Without an output specified, appearance options apply to all outputs.
14 Per-output appearance options can be set by passing -o, --output fol‐
15 lowed by these options.
16
18 -c, --color <#rrggbb>
19 Set the background color.
20
21 -h, --help
22 Show help message and quit.
23
24 -i, --image <path>
25 Set the background image.
26
27 -m, --mode <mode>
28 Scaling mode for images: stretch, fill, fit, center, or tile. Use
29 the additional mode solid_color to display only the background
30 color, even if a background image is specified.
31
32 -o, --output <name>
33 Select an output to configure. Subsequent appearance options will
34 only apply to this output. The special value * selects all outputs.
35
36 -v, --version
37 Show the version number and quit.
38
40 Maintained by Drew DeVault <sir@cmpwn.com>, who is assisted by other
41 open source contributors. For more information about swaybg develop‐
42 ment, see https://github.com/swaywm/swaybg.
43
44
45
46 2023-01-02 swaybg(1)