Go to file
Tomas Janousek 5ef093c3e2 dunstctl: Fix bashism in set-pause-level
Fixes: 6d250b5834 ("add multiple pause levels")
2023-11-10 14:39:43 +01:00
.github Enforce g_malloc over malloc in project 2023-02-27 09:59:42 +01:00
contrib remove d from pause level commands 2023-11-09 18:09:57 +01:00
docs Update docs/dunst.5.pod 2023-11-10 14:37:21 +01:00
src pod update, remove sort_ascending 2023-11-10 14:37:21 +01:00
test fix test setting invalid sort option 2023-11-10 14:37:21 +01:00
.gitignore Improve docs 2021-01-27 11:14:30 +01:00
.valgrind.suppressions Move memory leak handling to suppression file 2022-03-29 19:23:41 -06:00
AUTHORS release version 0.4.0 2012-09-27 12:17:25 +02:00
CHANGELOG.md Dunst v1.9.2 2023-04-20 18:55:58 +02:00
HACKING.md Fix some typos and language issues in the documentation 2023-08-29 14:20:35 +02:00
LICENSE update copyright year 2013-01-17 00:39:47 +01:00
Makefile Dunst v1.9.2 2023-04-20 18:55:58 +02:00
README.md add documentation for pause level 2023-11-09 18:09:57 +01:00
RELEASE_NOTES Dunst v1.9.2 2023-04-20 18:55:58 +02:00
config.mk make libnotify & dunstify optional 2022-11-23 12:56:00 +01:00
dunst.systemd.service.in Remove WantedBy in systemd unit file 2020-03-21 21:24:54 +01:00
dunstctl dunstctl: Fix bashism in set-pause-level 2023-11-10 14:39:43 +01:00
dunstify.c Change option description string 2023-03-14 00:55:50 +02:00
dunstrc pod update, remove sort_ascending 2023-11-10 14:37:21 +01:00
main.c Add filetype to vim modeline 2020-11-02 20:25:26 +01:00
org.knopwob.dunst.service.in Allow dunst to be managed by systemd 2017-02-15 14:17:39 -08:00


main codecov


A highly configurable and lightweight notification daemon.


Table of Contents


⚙️ Highly customizable

Customize fonts, icons, timeouts, and more. Are you unhappy with the default shortcuts and colors? No worries, you can change these all with a simple configuration file tweak.

click the images to see the dunstrc

screenshot1 screenshot2

📜 Scripting


Run custom scripts on notifications matching a specified pattern. Have espeak read out your notifications, or play a song when your significant other signs on in pidgin!

📋 Rules

Change the look or behavior of notifications matching a specified pattern. You could use this to change the color of message notifications from your favorite jabber buddies, or to prevent important work email notifications from disappearing until you manually dismiss them.

⏸️ Pause

If you want to take a break and not receive any notifications for a while, just pause dunst. All notifications will be saved for you to catch up later.

Additionally, you can set a numeric pause level, which allows you to pause dunst selectively for some notifications, where more urgent notifications get through, but less urgent stay paused.

🕘 History

Catch an unread notification disappearing from the corner of your eye? Just tap a keyboard shortcut to replay the last notification, or continue tapping to see your notification history.


Most documentation can be found in dunst's man pages. In dunst(1) contains some general instructions on how to run dunst and in dunst(5) all of dunst's configuration options are explained.

On the dunst wiki you can find guides and installation instructions and on the dunst website there is a FAQ with common issues.


Dunst is available in many package repositories. If it's not available in your distro's repositories, don't worry, it's not hard to build it yourself.


  • dbus (runtime)
  • libxinerama
  • libxrandr
  • libxss
  • glib
  • pango/cairo
  • libnotify (can build without, for dunstify, see make parameters)
  • wayland-client (can build without, see make parameters)
  • wayland-protocols (optional, for recompiling protocols)
  • xdg-utils (optional, xdg-open is the default 'browser' for opening URLs)

The names will be different depending on your distribution.


git clone https://github.com/dunst-project/dunst.git
cd dunst
sudo make install

Make parameters

  • DESTDIR=<PATH>: Set the destination directory of the installation. (Default: /)
  • PREFIX=<PATH>: Set the prefix of the installation. (Default: /usr/local)
  • BINDIR=<PATH>: Set the dunst executable's path (Default: ${PREFIX}/bin)
  • DATADIR=<PATH>: Set the path for shared files. (Default: ${PREFIX}/share)
  • SYSCONFDIR=<PATH>: Set the base directory for system config files. (Default: ${PREFIX}/etc/xdg)
  • SYSCONFFILE=<PATH>: Set the absolute path to which the default dunstrc shall be installed. (Default: ${SYSCONFDIR}/dunst/dunstrc)
  • SYSCONF_FORCE_NEW=(0|1): Overwrite existing ${SYSCONFFILE}. (Default: 0 (don't overwrite))
  • MANDIR=<PATH>: Set the prefix of the manpage. (Default: ${DATADIR}/man)
  • SYSTEMD=(0|1): Disable/Enable the systemd unit. (Default: autodetect systemd)
  • WAYLAND=(0|1): Disable/Enable wayland support. (Default: 1 (enabled))
  • DUNSTIFY=(0|1): Disable/Enable the libnotify dunstctl utility. (Default: 1 (enabled))
  • SERVICEDIR_SYSTEMD=<PATH>: The path to put the systemd user service file. Unused, if SYSTEMD=0. (Default: ${PREFIX}/lib/systemd/user)
  • SERVICEDIR_DBUS=<PATH>: The path to put the dbus service file. (Default: ${DATADIR}/dbus-1/services)
  • EXTRA_CFLAGS=<FLAGS>: Additional flags for the compiler.

Make sure to run all make calls with the same parameter set. So when building with make PREFIX=/usr, you have to install it with make PREFIX=/usr install, too.

Notes on default of XDG_CONFIG_DIRS

Dunst uses a different default (${SYSCONFDIR}) for XDG_CONFIG_DIRS at runtime. This is a slight digression from the recommended value in the XDG Base Directory Specification (/etc/xdg), because the default config file gets installed to ${SYSCONFDIR}/dunst/dunstrc to avoid conflicts with /etc/xdg/dunst/dunstrc which might have been installed from a distribution repository. If you do want dunst to use the spec's recommended default, set XDG_CONFIG_DIR=/etc/xdg at runtime or SYSCONFDIR=/etc/xdg at compile time.


Changing SYSCONFFILE does not affect the search for config files, meaning it will not take effect if you choose to install dunstrc to a location that cannot be found by the algorithm outlined in the FILES section of dunst(1).

make install will not overwrite an already existing ${SYSCONFFILE} (i.e. /usr/local/etc/xdg/dunst/dunstrc), see SYSCONF_FORCE_NEW above. This is so you do not lose local changes to said file on upgrade. However, it is recommended to leave that file untouched and use a more important config location to override settings, see the FILES section in dunst(1) for more details.

make uninstall will not remove ${SYSCONFFILE}, use make uninstall-purge if you do want it removed as well.


Contributions are very welcome. Before contributing, make sure to look at the contribution documentation in HACKING.md.

Make sure you test your code and where possible add automated tests. These tests are also checked on memory leaks (with make test-valgrind).


Cannot set settings via command line

This functionality was removed during the refactor. It might be re-added later in some form. See #940 for details.

Bug reports

Please use the issue tracker provided by GitHub to send us bug reports or feature requests.


screenshot3 progress



Written by Sascha Kruse dunst@knopwob.de

Copyright 2013 Sascha Kruse and contributors (see LICENSE for licensing information)