4 # Which monitor should the notifications be displayed on.
7 # Display notification on focused monitor. Possible modes are:
8 # mouse: follow mouse pointer
9 # keyboard: follow window with keyboard focus
10 # none: don't follow anything
12 # "keyboard" needs a window manager that exports the
13 # _NET_ACTIVE_WINDOW property.
14 # This should be the case for almost all modern window managers.
16 # If this option is set to mouse or keyboard, the monitor option
20 # The geometry of the window:
21 # [{width}]x{height}[+/-{x}+/-{y}]
22 # The geometry of the message window.
23 # The height is measured in number of notifications everything else
24 # in pixels. If the width is omitted but the height is given
25 # ("-geometry x2"), the message window expands over the whole screen
26 # (dmenu-like). If width is 0, the window expands to the longest
27 # message displayed. A positive x is measured from the left, a
28 # negative from the right side of the screen. Y is measured from
29 # the top and down respectively.
30 # The width can be negative. In this case the actual width is the
31 # screen width minus the width defined in within the geometry option.
32 geometry = "300x5-30+20"
34 # Show how many messages are currently hidden (because of geometry).
37 # Shrink window if it's smaller than the width. Will be ignored if
41 # The transparency of the window. Range: [0; 100].
42 # This option will only work if a compositing window manager is
43 # present (e.g. xcompmgr, compiz, etc.).
46 # The height of the entire notification. If the height is smaller
47 # than the font height and padding combined, it will be raised
48 # to the font height and padding.
49 notification_height = 0
51 # Draw a line of "separator_height" pixel height between two
53 # Set to 0 to disable.
56 # Padding between text and separator.
60 horizontal_padding = 8
62 # Defines width in pixels of frame around the notification window.
63 # Set to 0 to disable.
66 # Defines color of the frame around the notification window.
67 frame_color = "#aaaaaa"
69 # Define a color for the separator.
70 # possible values are:
71 # * auto: dunst tries to find a color fitting to the background;
72 # * foreground: use the same color as the foreground;
73 # * frame: use the same color as the frame;
74 # * anything else will be interpreted as a X color.
75 separator_color = frame
77 # Sort messages by urgency.
80 # Don't remove messages, if the user is idle (no mouse or keyboard input)
81 # for longer than idle_threshold seconds.
82 # Set to 0 to disable.
83 # A client can set the 'transient' hint to bypass this. See the rules
84 # section for how to disable this if necessary
91 # The spacing between lines. If the height is smaller than the
92 # font height, it will get raised to the font height.
95 # Possible values are:
96 # full: Allow a small subset of html markup in notifications:
99 # <s>strikethrough</s>
102 # For a complete reference see
103 # <https://developer.gnome.org/pango/stable/pango-Markup.html>.
105 # strip: This setting is provided for compatibility with some broken
106 # clients that send markup even though it's not enabled on the
107 # server. Dunst will try to strip the markup but the parsing is
108 # simplistic so using this option outside of matching rules for
109 # specific applications *IS GREATLY DISCOURAGED*.
111 # no: Disable markup parsing, incoming notifications will be treated as
112 # plain text. Dunst will not advertise that it has the body-markup
113 # capability if this is set as a global setting.
115 # It's important to note that markup inside the format option will be parsed
116 # regardless of what this is set to.
119 # The format of the message. Possible variables are:
123 # %i iconname (including its path)
124 # %I iconname (without its path)
125 # %p progress value if set ([ 0%] to [100%]) or nothing
126 # %n progress value if set without any extra characters
129 format = "<b>%s</b>\n%b"
131 # Alignment of message text.
132 # Possible values are "left", "center" and "right".
135 # Vertical alignment of message text and icon.
136 # Possible values are "top", "center" and "bottom".
137 vertical_alignment = center
139 # Show age of message if message is older than show_age_threshold
141 # Set to -1 to disable.
142 show_age_threshold = 60
144 # Split notifications into multiple lines if they don't fit into
148 # When word_wrap is set to no, specify where to make an ellipsis in long lines.
149 # Possible values are "start", "middle" and "end".
152 # Ignore newlines '\n' in notifications.
155 # Stack together notifications with the same content
156 stack_duplicates = true
158 # Hide the count of stacked notifications with the same content
159 hide_duplicate_count = false
161 # Display indicators for URLs (U) and actions (A).
162 show_indicators = yes
166 # Align icons left/right/off
167 icon_position = right
169 # Scale small icons up to this size, set to 0 to disable. Helpful
170 # for e.g. small files or high-dpi screens. In case of conflict,
171 # max_icon_size takes precedence over this.
174 # Scale larger icons down to this size, set to 0 to disable
177 # Paths to default icons.
178 icon_path = /usr/share/icons/gnome/16x16/status/:/usr/share/icons/gnome/16x16/devices/
182 # Should a notification popped up from history be sticky or timeout
183 # as if it would normally do.
186 # Maximum amount of notifications kept in history
189 ### Misc/Advanced ###
192 dmenu = /usr/bin/dmenu -p dunst:
194 # Browser for opening urls in context menu.
195 browser = /usr/bin/sensible-browser
197 # Always run rule-defined scripts, even if the notification is suppressed
198 always_run_script = true
200 # Define the title of the windows spawned by dunst
203 # Define the class of the windows spawned by dunst
206 # Print a notification on startup.
207 # This is mainly for error detection, since dbus (re-)starts dunst
208 # automatically after a crash.
209 startup_notification = false
211 # Manage dunst's desire for talking
212 # Can be one of the following values:
213 # crit: Critical features. Dunst aborts
214 # warn: Only non-fatal warnings
215 # mesg: Important Messages
216 # info: all unimportant stuff
217 # debug: all less than unimportant stuff
220 # Define the corner radius of the notification window
221 # in pixel size. If the radius is 0, you have no rounded
223 # The radius will be automatically lowered if it exceeds half of the
224 # notification height to avoid clipping text and/or icons.
227 # Ignore the dbus closeNotification message.
228 # Useful to enforce the timeout set by dunst configuration. Without this
229 # parameter, an application may close the notification sent before the
230 # user defined timeout.
231 ignore_dbusclose = false
235 # Use the Xinerama extension instead of RandR for multi-monitor support.
236 # This setting is provided for compatibility with older nVidia drivers that
237 # do not support RandR and using it on systems that support RandR is highly
240 # By enabling this setting dunst will not be able to detect when a monitor
241 # is connected or disconnected which might break follow mode if the screen
243 force_xinerama = false
247 # Defines list of actions for each mouse event
248 # Possible values are:
249 # * none: Don't do anything.
250 # * do_action: If the notification has exactly one action, or one is marked as default,
251 # invoke it. If there are multiple and no default, open the context menu.
252 # * close_current: Close current notification.
253 # * close_all: Close all notifications.
254 # These values can be strung together for each mouse event, and
255 # will be executed in sequence.
256 mouse_left_click = close_current
257 mouse_middle_click = do_action, close_current
258 mouse_right_click = close_all
260 # Experimental features that may or may not work correctly. Do not expect them
261 # to have a consistent behaviour across releases.
263 # Calculate the dpi to use on a per-monitor basis.
264 # If this setting is enabled the Xft.dpi value will be ignored and instead
265 # dunst will attempt to calculate an appropriate dpi value for each monitor
266 # using the resolution and physical size. This might be useful in setups
267 # where there are multiple screens with very different dpi values.
268 per_monitor_dpi = false
272 # Shortcuts are specified as [modifier+][modifier+]...key
273 # Available modifiers are "ctrl", "mod1" (the alt-key), "mod2",
274 # "mod3" and "mod4" (windows-key).
275 # Xev might be helpful to find names for keys.
277 # Close notification.
280 # Close all notifications.
281 close_all = ctrl+shift+space
283 # Redisplay last message(s).
284 # On the US keyboard layout "grave" is normally above TAB and left
285 # of "1". Make sure this key actually exists on your keyboard layout,
286 # e.g. check output of 'xmodmap -pke'
290 context = ctrl+shift+period
293 # IMPORTANT: colors have to be defined in quotation marks.
294 # Otherwise the "#" and following would be interpreted as a comment.
295 background = "#222222"
296 foreground = "#888888"
299 # Icon for notifications with low urgency, uncomment to enable
300 #icon = /path/to/icon
303 background = "#285577"
304 foreground = "#ffffff"
306 # Icon for notifications with normal urgency, uncomment to enable
307 #icon = /path/to/icon
310 background = "#900000"
311 foreground = "#ffffff"
312 frame_color = "#ff0000"
314 # Icon for notifications with critical urgency, uncomment to enable
315 #icon = /path/to/icon
317 # Every section that isn't one of the above is interpreted as a rules to
318 # override settings for certain messages.
320 # Messages can be matched by
321 # appname (discouraged, see desktop_entry)
331 # and you can override the
343 # Shell-like globbing will get expanded.
345 # Instead of the appname filter, it's recommended to use the desktop_entry filter.
346 # GLib based applications export their desktop-entry name. In comparison to the appname,
347 # the desktop-entry won't get localized.
350 # You can specify a script that gets run when the rule matches by
351 # setting the "script" option.
352 # The script will be called as follows:
353 # script appname summary body icon urgency
354 # where urgency can be "LOW", "NORMAL" or "CRITICAL".
356 # NOTE: if you don't want a notification to be displayed, set the format
358 # NOTE: It might be helpful to run dunst -print in a terminal in order
359 # to find fitting options for rules.
361 # Disable the transient hint so that idle_threshold cannot be bypassed from the
364 # match_transient = yes
367 # Make the handling of transient notifications more strict by making them not
368 # be placed in history.
369 #[transient_history_ignore]
370 # match_transient = yes
371 # history_ignore = yes
374 # show: show the notifications, regardless if there is a fullscreen window opened
375 # delay: displays the new notification, if there is no fullscreen window active
376 # If the notification is already drawn, it won't get undrawn.
377 # pushback: same as delay, but when switching into fullscreen, the notification will get
378 # withdrawn from screen again and will get delayed like a new notification
379 #[fullscreen_delay_everything]
381 #[fullscreen_show_critical]
382 # msg_urgency = critical
387 # script = dunst_espeak.sh
390 # summary = "*script*"
391 # script = dunst_test.sh
394 # # This notification will not be displayed
399 # # This notification will not be saved in history
401 # history_ignore = yes
404 # # This notification will not be displayed, but will be included in the history
410 # summary = "*signed on*"
415 # summary = *signed off*
425 # summary = *twitter.com*
429 # appname = "some_volume_notifiers"
430 # set_stack_tag = "volume"