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 # <http://developer.gnome.org/pango/stable/PangoMarkupFormat.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 # Show age of message if message is older than show_age_threshold
137 # Set to -1 to disable.
138 show_age_threshold = 60
140 # Split notifications into multiple lines if they don't fit into
144 # When word_wrap is set to no, specify where to make an ellipsis in long lines.
145 # Possible values are "start", "middle" and "end".
148 # Ignore newlines '\n' in notifications.
151 # Stack together notifications with the same content
152 stack_duplicates = true
154 # Hide the count of stacked notifications with the same content
155 hide_duplicate_count = false
157 # Display indicators for URLs (U) and actions (A).
158 show_indicators = yes
162 # Align icons left/right/off
165 # Scale larger icons down to this size, set to 0 to disable
168 # Paths to default icons.
169 icon_path = /usr/share/icons/gnome/16x16/status/:/usr/share/icons/gnome/16x16/devices/
173 # Should a notification popped up from history be sticky or timeout
174 # as if it would normally do.
177 # Maximum amount of notifications kept in history
180 ### Misc/Advanced ###
183 dmenu = /usr/bin/dmenu -p dunst:
185 # Browser for opening urls in context menu.
186 browser = /usr/bin/firefox -new-tab
188 # Always run rule-defined scripts, even if the notification is suppressed
189 always_run_script = true
191 # Define the title of the windows spawned by dunst
194 # Define the class of the windows spawned by dunst
197 # Print a notification on startup.
198 # This is mainly for error detection, since dbus (re-)starts dunst
199 # automatically after a crash.
200 startup_notification = false
202 # Manage dunst's desire for talking
203 # Can be one of the following values:
204 # crit: Critical features. Dunst aborts
205 # warn: Only non-fatal warnings
206 # mesg: Important Messages
207 # info: all unimportant stuff
208 # debug: all less than unimportant stuff
211 # Define the corner radius of the notification window
212 # in pixel size. If the radius is 0, you have no rounded
214 # The radius will be automatically lowered if it exceeds half of the
215 # notification height to avoid clipping text and/or icons.
220 # Use the Xinerama extension instead of RandR for multi-monitor support.
221 # This setting is provided for compatibility with older nVidia drivers that
222 # do not support RandR and using it on systems that support RandR is highly
225 # By enabling this setting dunst will not be able to detect when a monitor
226 # is connected or disconnected which might break follow mode if the screen
228 force_xinerama = false
232 # Defines action of mouse event
233 # Possible values are:
234 # * none: Don't do anything.
235 # * do_action: If the notification has exactly one action, or one is marked as default,
236 # invoke it. If there are multiple and no default, open the context menu.
237 # * close_current: Close current notification.
238 # * close_all: Close all notifications.
239 mouse_left_click = close_current
240 mouse_middle_click = do_action
241 mouse_right_click = close_all
243 # Experimental features that may or may not work correctly. Do not expect them
244 # to have a consistent behaviour across releases.
246 # Calculate the dpi to use on a per-monitor basis.
247 # If this setting is enabled the Xft.dpi value will be ignored and instead
248 # dunst will attempt to calculate an appropriate dpi value for each monitor
249 # using the resolution and physical size. This might be useful in setups
250 # where there are multiple screens with very different dpi values.
251 per_monitor_dpi = false
255 # Shortcuts are specified as [modifier+][modifier+]...key
256 # Available modifiers are "ctrl", "mod1" (the alt-key), "mod2",
257 # "mod3" and "mod4" (windows-key).
258 # Xev might be helpful to find names for keys.
260 # Close notification.
263 # Close all notifications.
264 close_all = ctrl+shift+space
266 # Redisplay last message(s).
267 # On the US keyboard layout "grave" is normally above TAB and left
268 # of "1". Make sure this key actually exists on your keyboard layout,
269 # e.g. check output of 'xmodmap -pke'
273 context = ctrl+shift+period
276 # IMPORTANT: colors have to be defined in quotation marks.
277 # Otherwise the "#" and following would be interpreted as a comment.
278 background = "#222222"
279 foreground = "#888888"
281 # Icon for notifications with low urgency, uncomment to enable
282 #icon = /path/to/icon
285 background = "#285577"
286 foreground = "#ffffff"
288 # Icon for notifications with normal urgency, uncomment to enable
289 #icon = /path/to/icon
292 background = "#900000"
293 foreground = "#ffffff"
294 frame_color = "#ff0000"
296 # Icon for notifications with critical urgency, uncomment to enable
297 #icon = /path/to/icon
299 # Every section that isn't one of the above is interpreted as a rules to
300 # override settings for certain messages.
302 # Messages can be matched by
303 # appname (discouraged, see desktop_entry)
313 # and you can override the
325 # Shell-like globbing will get expanded.
327 # Instead of the appname filter, it's recommended to use the desktop_entry filter.
328 # GLib based applications export their desktop-entry name. In comparison to the appname,
329 # the desktop-entry won't get localized.
332 # You can specify a script that gets run when the rule matches by
333 # setting the "script" option.
334 # The script will be called as follows:
335 # script appname summary body icon urgency
336 # where urgency can be "LOW", "NORMAL" or "CRITICAL".
338 # NOTE: if you don't want a notification to be displayed, set the format
340 # NOTE: It might be helpful to run dunst -print in a terminal in order
341 # to find fitting options for rules.
343 # Disable the transient hint so that idle_threshold cannot be bypassed from the
346 # match_transient = yes
349 # Make the handling of transient notifications more strict by making them not
350 # be placed in history.
351 #[transient_history_ignore]
352 # match_transient = yes
353 # history_ignore = yes
356 # show: show the notifications, regardless if there is a fullscreen window opened
357 # delay: displays the new notification, if there is no fullscreen window active
358 # If the notification is already drawn, it won't get undrawn.
359 # pushback: same as delay, but when switching into fullscreen, the notification will get
360 # withdrawn from screen again and will get delayed like a new notification
361 #[fullscreen_delay_everything]
363 #[fullscreen_show_critical]
364 # msg_urgency = critical
369 # script = dunst_espeak.sh
372 # summary = "*script*"
373 # script = dunst_test.sh
376 # # This notification will not be displayed
381 # # This notification will not be saved in history
383 # history_ignore = yes
386 # # This notification will not be displayed, but will be included in the history
392 # summary = "*signed on*"
397 # summary = *signed off*
407 # summary = *twitter.com*
411 # appname = "some_volume_notifiers"
412 # set_stack_tag = "volume"