Skip to content
Switch branches/tags


swaybg is a wallpaper utility for Wayland compositors. It is compatible with any Wayland compositor which implements the following Wayland protocols:

  • wlr-layer-shell
  • xdg-output
  • xdg-shell

See the man page, swaybg(1), for instructions on using swaybg.

Release Signatures

Releases are signed with E88F5E48 and published on GitHub. swaybg releases are managed independently of sway releases.


From Packages

swaybg is available in many distributions. Try installing the "swaybg" package for yours.

If you're interested in packaging swaybg for your distribution, stop by the IRC channel or shoot an email to for advice.

Compiling from Source

Install dependencies:

  • meson *
  • wayland
  • wayland-protocols *
  • cairo
  • gdk-pixbuf2 (optional: image formats other than PNG)
  • scdoc (optional: man pages) *
  • git (optional: version information) *

* Compile-time dep

Run these commands:

meson build/
ninja -C build/
sudo ninja -C build/ install