dunst-project /dunst

Lightweight and customizable notification daemon

★ 5,630⑂ 382👁 48⑃ 571● 949▤ 27
CNOASSERTIONCreated 2011-09-07dunst-project.org
Download: Dunst v1.13.2Dunst-1.13.2 ↓1.13.22026-03-18
+0
Daily
5,630
stars
382
forks
48
watchers
571
prs
949
issues
27
releases

README

[![main][main-badge]][main-link] [![extra][extra-badge]][extra-link] [![codecov][codecov-badge]][codecov-link]

[main-badge]: https://github.com/dunst-project/dunst/actions/workflows/main.yml/badge.svg?branch=master
[main-link]: https://github.com/dunst-project/dunst/actions?query=workflow%3Amain
[extra-badge]: https://github.com/dunst-project/dunst/actions/workflows/extra.yml/badge.svg?event=push&branch=master
[extra-link]: https://github.com/dunst-project/dunst/actions?query=workflow%3Aextra
[codecov-badge]: https://codecov.io/gh/dunst-project/dunst/branch/master/graph/badge.svg
[codecov-link]: https://codecov.io/gh/dunst-project/dunst

 Dunst

A highly configurable and lightweight notification daemon.

!music

 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][wiki] you can find guides and installation instructions and
on the dunst [website][website] there is a [FAQ][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)

Th

Top issues

Discussions

Latest release

Dunst v1.13.2 v1.13.2 2026-03-18
1.13.2 -- 2026-03-18

 Added
- Add experimental support for PCRE regex (see manual) (1536)
- Add fullscreen suppress mode (1539, 1187)
- Add dunstify shorthand for stack-tags (--stack-tag) (1540)

 Changed
- Improve doxygen docs (1538)
- Make the build more generic and improve support for FreeBSD (1537)

 Fixed
- Run script for duplicate notifications (1542, 1115)
- Add NULL check in wayland toplevel events
- Fix markup newline parsing (1054)
- Restore dunstify -a and update docs


----
Full Changelog: https://github.com/dunst-project/dunst/compare/v1.13.1...v1.13.2

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON