This project is not being actively maintained. I currently do not have the time nor energy to continue working on it
Bugfix: removed malloc() exception caused when using --pre-display-cmd
Added the single_click config option
Added the with_list() variants of the insert text and insert image functions in widget builder to the man pages


browse log
browse .tar.gz




Wofi is a launcher/menu program for wlroots based wayland compositors such as sway status




hg clone
cd wofi
meson build
ninja -C build


sudo ninja -C build install


sudo ninja -C build uninstall

#Bug Reports

Please file bug reports at


Please submit patches to

You can find documentation here

#drun and dbus

Some desktop files declare themselves as being launched by dbus, if this is the case wofi can experience issues on systems where a user session bus is not automatically started such as systems using elogind.

To manually launch a user session bus run the following:

dbus-daemon --session --address=unix:path=$XDG_RUNTIME_DIR/bus


Debian sid has a package in the official repos

Ubuntu focal has a package in universe

Arch has an AUR package for the current tip and an official package for the current stable

NixOS has a packge in unstable

Void Linux also has a package

Fedora has an official package as well as one in COPR

FreeBSD has an official package

Gentoo has a portage overlay


The official documentation is provided by the man pages in this repository, sample styling can be found here


If you feel like supporting development you can either donate one time or support me monthly


example 4