Skip to Content
Matuwall

Installation

Install Matuwall on Arch Linux, NixOS, FreeBSD or from source

Arch Linux

Install the prebuilt package from the AUR:

yay -S matuwall-bin

NixOS

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.matuwall

Without the overlay, use matuwall.packages.${system}.default.

Try it without installing:

nix run github:naurissteins/Matuwall

FreeBSD

FreeBSD 15 is tested. Install the build dependencies as root:

pkg install meson ninja pkgconf wayland wayland-protocols libxkbcommon png jpeg-turbo webp scdoc

Then 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, libwebp
  • scdoc (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 install

Or install to your home directory:

meson setup build --buildtype=release --prefix="$HOME/.local"
ninja -C build
ninja -C build install

Make sure ~/.local/bin is in your PATH.

Wallpaper Daemon

Matuwall needs a running daemon to apply wallpapers. Install one:

DaemonNotes
awwwDefault backend, with transition animations. In nixpkgs and FreeBSD pkg
sweetbgMinimal
KDE PlasmaNo daemon needed. Use backend = "plasma"

See Backends for custom setters like hyprpaper or swaybg.

Check the Install

matuwall --version
matuwall --diagnose

ERROR means normal use is blocked. WARN is non-blocking.

Next: Quick Start

On this page