A server-side entry in TopGit's GitHub warehouse: dunst-project/dunst, 5.6k stars, Backend, C. Lightweight and customizable notification daemon
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
A highly configurable and lightweight notification daemon.
Table of Contents
Features
Building
Contributing
Documentation
Troubleshooting
Copyright
Features
⚙️ 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
📜 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.
Documentation
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.
Installation
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.
Dependencies
gdk-pixbuf-2.0
glib-2.0
gio-2.0
pangocairo (provided by pango + cairo)
libnotify (optional, for dunstify)
wayland-client (optional, for wayland)
wayland-cursor (optional, for wayland)
x11 (optional, for xorg)
xinerama (optional, for xorg)
xext (optional, for xorg)
xrandr (optional, for xorg)
xscrnsaver (optional, for xorg)
The names will be different depending on your distribution.
See more here.
Building
Makefile
git clone https://github.com/dunst-project/dunst.git
cd dunst
make
sudo make install
DUNSTIFY=(0|1): Disable/Enable the libnotify dunstctl utility. (Default: 1 (enabled))
COMPLETIONS=(0|1): Disable/Enable installation of shell completions. (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.
Either X11 or WAYLAND should be set, otherwise dunst will not compile.
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.
Notes on SYSCONFFILE
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.
Contributing
Contributions are very welcome. Before contributing, make sure to look at the
contribution documentation in CONTRIBUTING.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).
Bug reports
Please use the issue tracker provided by GitHub to send us bug reports or feature requests.
The most recent commit recorded on dunst-project/dunst was 5 months ago, based on the GitHub push timestamp. The repository has 383 forks — one of the better signals of community interest.
How many stars does dunst-project/dunst have?
dunst-project/dunst has 5.6k GitHub stars — refresh the page for the live number, or check github.com/dunst-project/dunst. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is dunst-project/dunst open source?
TopGit's metadata for dunst-project/dunst does not record a license. Most public repositories on GitHub ARE open source, but the exact terms vary — verify by opening the LICENSE file directly.
What else is in the Backend space?
dunst-project/dunst is tracked by TopGit under the Backend category, alongside 6 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What topics is dunst-project/dunst associated with?
GitHub's repository topics for dunst-project/dunst: "c", "dbus", "libnotify", "notification-daemon", "wayland", "x11". TopGit's editorial category is Backend.
Where can I see dunst-project/dunst in action?
The project maintains a homepage at https://dunst-project.org. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about dunst-project/dunst?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/dunst-project/dunst is the definitive source.
Read full README in the tab above.
Still deciding about dunst?
One click hands the question to an AI along with this page — see what it says about dunst.