★ A simple launcher panel for Wayland desktops ★
Add config option to enable/disable use of foreign toplevel management
Add rounded corners
Change default configuration file path loading



You can also use your local clone with git send-email.



LavaLauncher is a simple launcher for Wayland.

It serves a single purpose: Letting the user execute shell commands by clicking on icons on a dynamically sized bar, placed at one of the screen edges.

Unlike most popular launchers, LavaLauncher does not care about .desktop files or icon themes and it does not track open applications; It is not a dock. To create a button, you simply provide the path to an image and a shell command. This makes LavaLauncher considerably more flexible: You could have buttons not just for launching applications, but also for ejecting your optical drive, rotating your screen, sending your cat an email, playing a funny sound, muting all audio, toggling your lamps, etc. You can turn practically anything you could do in your shell into a button.

LavaLauncher is opinionated, yet remains configurable. The configuration syntax is documented in the man page.

LavaLauncher has been successfully tested on sway, wayfire, river and hikari.



The following distributions have an official LavaLauncher package:

  • Fedora
  • Gentoo


LavaLauncher depends on Wayland, Wayland protocols and Cairo. To compile LavaLauncher with SVG image support, it additionally depends on librsvg.

To build this program you will need a C compiler, the meson & ninja build system and scdoc to generate the manpage.

git clone https://git.sr.ht/~leon_plickat/lavalauncher
cd lavalauncher
meson build
ninja -C build
sudo ninja -C build install


The mailinglist is for bug reports, contributions, feedback and getting help.


If you found this project on GitHub or any other platform having some sort of special system for contributions, bug reports, questions, feedback or whatever, be aware that 1) I massively prefer the mailing list based workflow and 2) that platform is only used as a mirror. Try your luck, but know that I do not guarantee that I will notice your message.


Contributions are welcome! Read CONTRIBUTING.md to find out how you can contribute.


LavaLauncher is licensed under the GPLv3.

The contents of the protocol directory are licensed differently. See the header of the files for more information.


Leon Plickat leonhenrik.plickat@stud.uni-goettingen.de