hatwmbg is a small Wayland wallpaper client intended for HatWM and other
compositors implementing wlr-layer-shell-unstable-v1.
It creates one background-layer surface per output and center-crops the image
with fill scaling. JPEG, PNG, and GIF images are decoded internally; no
external wallpaper daemon is required.
Requirements:
- Go
- Meson
- Ninja
- Wayland client development files
- Cairo development files
pkg-config
meson setup build
meson compile -C buildMeson uses Ninja as its default backend. Build files and the executable are
kept out of the source tree; the resulting binary is build/hatwmbg.
Run the test suite with:
meson test -C build./build/hatwmbg ~/Pictures/Wallpapers/wallpaper.pngThe explicit form is:
./build/hatwmbg --mode fill IMAGEHatWM can start and supervise hatwmbg for its configured wallpaper. Install
the executable somewhere in HatWM's PATH:
sudo meson install -C buildThe default prefix is /usr/local. Choose another prefix during initial setup,
for example meson setup build --prefix=/usr. To remove files installed by
Meson, run sudo ninja -C build uninstall.
hatwmbg is available under the MIT License.