Setting up wayland.fyi software on Void Linux (2026-09-16)

This is a guide on how to download, build, and run some of the software from wayland.fyi on a fresh Void Linux install. Both glibc and musl versions were tested and work. This guide will not cover the Void Linux installation, please refer to their documentation

---

Repositories

• Libraries
  • neuwld
  • neuswc
• Compositors
  • tohu
  • wsxwm
• Application launchers
  • neumenu
• Terminal emulators
  • hst
  • havoc
• Wallpaper utilities
  • wawa
• Bars
  • mojito

---

Installing dependencies

Run the following command to install all the required dependencies:

sudo xbps-install -S git meson ninja base-devel pkg-config wayland \
wayland-devel wayland-protocols fontconfig-devel pixman-devel  \
libdrm-devel libinput-devel libxkbcommon-devel liberation-fonts-ttf

Clone the repositories using git clone URL using the links above (right click -> Copy Link)

The default text editor is vi, if you’d prefer, install a different text editor such as nano, vim, or neovim (run using nvim)

---

Files to modify

• /etc/rc.local (requires sudo)

# From https://man.sr.ht/~kennylevinsen/seatd/#using-simple-scripts
USER="your_user"
GROUP="your_group"

XDG_RUNTIME_DIR=/run/user/`id -u $USER`
if [ $? -ne 0]
then
 echo "No such user $USER"
 exit 1
fi

# Delete existing directory, create a new one and set permissions
rm -rf $XDG_RUNTIME_DIR
mkdir -p $XDG_RUNTIME_DIR
chown $USER:$GROUP $XDG_RUNTIME_DIR
chmod 700 $XDG_RUNTIME_DIR

• /etc/environment (requires sudo)

PKG_CONFIG_PATH="/usr/local/lib/pkgconfig"

• ~/.bashrc

export XDG_RUNTIME_DIR=/run/user/`id -u`
export XDG_CACHE_HOME="${HOME}/.cache"
export XDG_CONFIG_HOME="${HOME}/.config"
export XDG_DATA_HOME="${HOME}/.local/share"
export XDG_STATE_HOME="${HOME}/.local/state"

---

Build and install

neuwld

• meson setup build
• ninja -C build
• sudo ninja -C build install

neuswc

• meson setup build
• ninja -C build
• sudo ninja -C build install

tohu

• ninja
• sudo ninja install

wsxwm

• make LDLIBS=“-lswc -lwld -lwayland-server”
• sudo cp

neumenu

• Make changes to config.mk
  • SWCPROTO = /usr/local/share/swc.xml
• make
• sudo make clean install

hst

• make
• sudo make clean install

havoc

• make CFLAG=“-O2 -DNDEBUG”
• sudo make install

wawa

• make
• sudo make install

mojito

• make
• sudo make clean install