Skip to content
Wallpaper tool for Wayland compositors
C Meson SuperCollider
Branch: master
Clone or download


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 B22DA89A 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 **
  • scdoc (optional: man pages) *
  • git *

*Compile-time dep

**optional: required for background images other than PNG

Run these commands:

meson build
ninja -C build
sudo ninja -C build install
You can’t perform that action at this time.