Skip to content
AJ Reifsnyder edited this page Sep 14, 2023 · 15 revisions

Wiki

Welcome to the dunst wiki!

Getting started

First install dunst, see Installation. After installation, you can start right away. Copy the example dunstrc from /etc/xdg/dunst/dunstrc to ~/.config/dunst/dunstrc .

Try using this command to see if everything works:

dunstify "It works"

There should see a notifications that looks something like this:

It works notification

It may look differently, depending on the configuration. To check if you're actually running dunst and not another notification daemon, run dunstctl debug. It will also tell you what version of dunst is running. If dunst is not running, then run dunst before sending a notification.

If it worked, great! You can now start customizing your dunstrc.

In the example config there are lots of comments that will help you understand the different options. Look at the man page for a more extensive explanation. For inspiration take a look at this issue. Feel free to post your own too.

Guides

Check out the guides for in depth explanations with examples.

Frequently Asked Questions

Find answers to our FAQ on the website.

If you want to contribute, open a Pull request at dunst-project/dunst-project.org

Questions or need help?

You can talk to us on the IRC channel: #dunst on Libera.