Just a dump of the inline documentation for the EndeavourOS dunst user defaults.
Global Settings
Display
Which monitor notifications should be displayed on.
I only have one, so it’s an easy choice.
Display notification on focused monitor. Possible modes are:
mouse
- follow mouse pointer
keyboard
- follow window with keyboard focus
none
- don’t follow anything
keyboard
needs a window manager that exports the_NET_ACTIVE_WINDOW
property. This should be the case for almost all modern window managers.If this option is set to mouse or keyboard, the monitor option will be ignored.
The geometry of the window:
[{width}]x{height}[+/-{x}+/-{y}]
The geometry of the message window.
The height is measured in number of notifications everything else in pixels. If the width is omitted but the height is given (
"-geometry x2"
), the message window expands over the whole screen (dmenu-like). If width is 0, the window expands to the longest message displayed. A positive x is measured from the left, a negative from the right side of the screen. Y is measured from the top and down respectively.The width can be negative. In this case the actual width is the screen width minus the width defined in within the geometry option.
Show how many messages are currently hidden (because of geometry).
Shrink window if it’s smaller than the width. Will be ignored if width is 0.
The transparency of the window. Range: [0; 100].
This option will only work if a compositing window manager is present (e.g. xcompmgr, compiz, etc.).
The height of the entire notification. If the height is smaller than the font height and padding combined, it will be raised to the font height and padding.
Draw a line of
separator_height
pixel height between two notifications.Set to
0
to disable.
Padding between text and separator.
Horizontal padding.
Defines width in pixels of frame around the notification window.
Set to 0 to disable.
Defines color of the frame around the notification window.
Define a color for the separator. possible values are:
auto
- dunst tries to find a color fitting to the background
foreground
- use the same color as the foreground
frame
- use the same color as the frame
Anything else will be interpreted as a X color.
Sort messages by urgency.
Don’t remove messages, if the user is idle (no mouse or keyboard input) for longer than idle_threshold seconds.
Set to 0 to disable.
A client can set the ’transient’ hint to bypass this. See the rules section for how to disable this if necessary
Text
The spacing between lines. If the height is smaller than the font height, it will get raised to the font height.
Possible values are:
- full
- Allow a small subset of html markup in notifications. For a complete reference see http://developer.gnome.org/pango/stable/PangoMarkupFormat.html.
- strip
- This setting is provided for compatibility with some broken clients that send markup even though it’s not enabled on the server. Dunst will try to strip the markup but the parsing is simplistic so using this option outside of matching rules for specific applications IS GREATLY DISCOURAGED.
- no
- Disable markup parsing, incoming notifications will be treated as plain text. Dunst will not advertise that it has the body-markup capability if this is set as a global setting.
It’s important to note that markup inside the format option will be parsed regardless of what this is set to.
The format of the message. Possible variables are:
Variable Represents %a
appname %s
summary %b
body %i
iconname (including its path) %I
iconname (without its path) %p
progress value if set ([ 0%] to [100%]) or nothing %n
progress value if set without any extra characters %%
Literal %
Markup is allowed
Alignment of message text.
Possible values are “left”, “center” and “right”.
Show age of message if message is older than
show_age_threshold
seconds.Set to
-1
to disable.
Split notifications into multiple lines if they don’t fit into geometry.
When word_wrap is set to no, specify where to make an ellipsis in long lines.
Possible values are “start”, “middle” and “end”.
Ignore newlines
\n
in notifications.
Stack together notifications with the same content
Hide the count of stacked notifications with the same content
Display indicators for URLs (U) and actions (A).
Icons
Align icons left/right/off
Scale larger icons down to this size, set to 0 to disable
icon_path =
/usr/share/icons/gnome/16x16/status/:/usr/share/icons/gnome/16x16/devices/
History
Should a notification popped up from history be sticky or timeout as if it would normally do.
Maximum amount of notifications kept in history
Misc / Advanced
dmenu path.
Browser for opening urls in context menu.
Defaults to Brave. I use Firefox.
Always run rule-defined scripts, even if the notification is suppressed
Define the title of the windows spawned by dunst
Define the class of the windows spawned by dunst
Print a notification on startup.
This is mainly for error detection, since dbus (re-)starts dunst automatically after a crash.
Manage dunst’s desire for talking
Can be one of the following values:
- crit
- Critical features. Dunst aborts
- warn
- Only non-fatal warnings
- mesg
- Important Messages
- info
- all unimportant stuff
- ebug
- all less than unimportant stuff
Define the corner radius of the notification window in pixel size. If the radius is 0, you have no rounded corners.
The radius will be automatically lowered if it exceeds half of the notification height to avoid clipping text and/or icons.
Legacy
Use the Xinerama extension instead of RandR for multi-monitor support. This setting is provided for compatibility with older nVidia drivers that do not support RandR and using it on systems that support RandR is highly discouraged.
By enabling this setting dunst will not be able to detect when a monitor is connected or disconnected which might break follow mode if the screen layout changes.
Mouse
Defines action of mouse event
Possible values are:
none
- Don’t do anything.
do_action
- If the notification has exactly one action, or one is marked as default, invoke it. If there are multiple and no default, open the context menu.
close_current
- Close current notification.
close_all
- Close all notifications.
Experimental
Experimental features that may or may not work correctly. Do not expect them to have a consistent behaviour across releases.
Calculate the dpi to use on a per-monitor basis.
If this setting is enabled the Xft.dpi value will be ignored and instead dunst will attempt to calculate an appropriate dpi value for each monitor using the resolution and physical size. This might be useful in setups where there are multiple screens with very different dpi values.
Shortcuts
Shortcuts are specified as
[modifier+][modifier+]...key
Available modifiers are “ctrl”, “mod1” (the alt-key), “mod2”, “mod3” and “mod4” (windows-key).
Xev might be helpful to find names for keys.
Close notification.
Close all notifications.
Redisplay last message(s).
On the US keyboard layout “grave” is normally above TAB and left of “1”. Make sure this key actually exists on your keyboard layout, e.g. check output of
xmodmap -pke
Context menu.
Low Urgency Notifications
IMPORTANT: colors have to be defined in quotation marks. Otherwise the “#” and following would be interpreted as a comment.
Normal Urgency Notifications
Critical Urgency Notifications
Everything else
There’s a lot. See the EndeavourOS Qtile Community Edition dunstrc for the whole thing.
Added to vault 2024-01-15. Updated on 2024-02-01