Installation
Install Matuwall on Arch Linux, NixOS, FreeBSD or from source
Arch Linux
Install the prebuilt package from the AUR:
yay -S matuwall-binNixOS
Add the flake input:
inputs.matuwall = {
url = "github:naurissteins/Matuwall";
inputs.nixpkgs.follows = "nixpkgs";
};Add the overlay, then install pkgs.matuwall:
{ nixpkgs.overlays = [ matuwall.overlays.default ]; }
# in home.packages or environment.systemPackages
pkgs.matuwallWithout the overlay, use matuwall.packages.${system}.default.
Try it without installing:
nix run github:naurissteins/MatuwallFreeBSD
FreeBSD 15 is tested. Install the build dependencies as root:
pkg install meson ninja pkgconf wayland wayland-protocols libxkbcommon png jpeg-turbo webp scdocThen build from source. The default prefix is /usr/local.
Matuwall needs XDG_RUNTIME_DIR. Most Wayland logins set it. Check with echo $XDG_RUNTIME_DIR.
Build from Source
Requirements:
- C11 compiler
- Meson 0.60 or newer, Ninja,
pkg-config xkbcommon,libpng,libjpeg-turbo,libwebpscdoc(man pages only)
Build and install system-wide:
git clone https://github.com/naurissteins/Matuwall.git
cd Matuwall
meson setup build --buildtype=release
ninja -C build
sudo ninja -C build installOr install to your home directory:
meson setup build --buildtype=release --prefix="$HOME/.local"
ninja -C build
ninja -C build installMake sure ~/.local/bin is in your PATH.
Wallpaper Daemon
Matuwall needs a running daemon to apply wallpapers. Install one:
| Daemon | Notes |
|---|---|
awww | Default backend, with transition animations. In nixpkgs and FreeBSD pkg |
sweetbg | Minimal |
| KDE Plasma | No daemon needed. Use backend = "plasma" |
See Backends for custom setters like hyprpaper or swaybg.
Check the Install
matuwall --version
matuwall --diagnoseERROR means normal use is blocked. WARN is non-blocking.
Next: Quick Start