Home · Dunst
Dunst is a lightweight replacement for the notification daemons provided by most desktop environments. It's very customizable, isn't dependent on any toolkits, and therefore fits into those window manager centric setups we all love to customize to perfection.
Features
Customizability
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. Hot reloading is supported if you want to change configuration on the fly.
Rules
Change the look or behavior of notifications matching specific patterns. You could use this to change the color of notifications from your favorite buddies, or to prevent important work notifications from disappearing until you manually dismiss them.
Environment agnostic
Both the X11 and Wayland window systems are natively supported. Dunst can be used in a wide variety of Unix-like environments (Linux distros, BSDs, etc.) thanks to its lightweight nature and minimal dependencies.
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.
Pause levels
Multiple pause levels are supported, so you can specify the priority of notification and selectively pause them. You could use this fine-grained approach to make a Do Not Disturb mode tailored to your needs.
Keyboard-Driven
Keyboard shortcuts can be bound to commands like closing the oldest notification, closing all notifications, and showing history. The mouse can be used too - left-click to dismiss a notification, or right-click to dismiss them all.
Multi-monitor Support
Specify the monitor that notifications should display on, or have them appear on the monitor with keyboard or mouse focus.
Context Menu
Use a keyboard shortcut to open a context menu (via dmenu) for the currently displayed notifications. It allows you to open the notifications' URLs in the browser or to perform the associated actions.
Scriptable
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!
Bug reports
Please use the issue tracker on GitHub to send us bug reports or feature requests.
Before reporting please refer to the FAQ and documentation.
Maintainers
- Federico Angelilli code@fedang.net
- Friso Smit fw.smit01@gmail.com
- Bjoern Hiller bjoern.hiller@gmail.com
Please only refer to active maintainers for issues and bugs!
Previous Maintainers
Sascha Kruse dunst@knopwob.de
License
Licenced under the terms of the 3-clause BSD License.
Copyright (c) 2013, Sascha Kruse knopwob@gmail.com All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
- Neither the name of Sascha Kruse nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.