Home
Welcome to the dunst wiki!
First install dunst, see Installation. After installation, you can start right away.
Copy the example dunstrc from /etc/xdg/dunst/dunstrc (or possibly /etc/dunst/dunstrc, depending on your platform) 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 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.
Check out the guides for in depth explanations with examples.
Find answers to our FAQ section.
Feel free to contribute to our wiki to help other users.
Please open an issue (after carefully checking for duplicates) or start a Discussion.