dunstrc

  1[global]
  2    ### Display ###
  3
  4    # Which monitor should the notifications be displayed on.
  5    monitor = 0
  6
  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
 11    #
 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.
 15    #
 16    # If this option is set to mouse or keyboard, the monitor option
 17    # will be ignored.
 18    follow = none
 19
 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 = "300x0-23+46"
 33
 34    # Show how many messages are currently hidden (because of geometry).
 35    indicate_hidden = yes
 36
 37    # Shrink window if it's smaller than the width.  Will be ignored if
 38    # width is 0.
 39    shrink = no
 40
 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.).
 44    transparency = 0
 45
 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
 50
 51    # Draw a line of "separator_height" pixel height between two
 52    # notifications.
 53    # Set to 0 to disable.
 54    separator_height = 2
 55
 56    # Padding between text and separator.
 57    padding = 8
 58
 59    # Horizontal padding.
 60    horizontal_padding = 8
 61
 62    # Defines width in pixels of frame around the notification window.
 63    # Set to 0 to disable.
 64    frame_width = 2
 65
 66    # Defines color of the frame around the notification window.
 67    frame_color = "#F8F8F2"
 68
 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
 76
 77    # Sort messages by urgency.
 78    sort = yes
 79
 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
 85    idle_threshold = 1
 86
 87    ### Text ###
 88
 89    font = Triplicate T4
 90
 91    # The spacing between lines.  If the height is smaller than the
 92    # font height, it will get raised to the font height.
 93    line_height = 0
 94
 95    # Possible values are:
 96    # full: Allow a small subset of html markup in notifications:
 97    #        <b>bold</b>
 98    #        <i>italic</i>
 99    #        <s>strikethrough</s>
100    #        <u>underline</u>
101    #
102    #        For a complete reference see
103    #        <https://developer.gnome.org/pango/stable/pango-Markup.html>.
104    #
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*.
110    #
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.
114    #
115    # It's important to note that markup inside the format option will be parsed
116    # regardless of what this is set to.
117    markup = full
118
119    # The format of the message.  Possible variables are:
120    #   %a  appname
121    #   %s  summary
122    #   %b  body
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
127    #   %%  Literal %
128    # Markup is allowed
129    format = "<b>%s</b>\n%b"
130
131    # Alignment of message text.
132    # Possible values are "left", "center" and "right".
133    alignment = left
134
135    # Vertical alignment of message text and icon.
136    # Possible values are "top", "center" and "bottom".
137    vertical_alignment = center
138
139    # Show age of message if message is older than show_age_threshold
140    # seconds.
141    # Set to -1 to disable.
142    show_age_threshold = 60
143
144    # Split notifications into multiple lines if they don't fit into
145    # geometry.
146    word_wrap = yes
147
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".
150    ellipsize = middle
151
152    # Ignore newlines '\n' in notifications.
153    ignore_newline = no
154
155    # Stack together notifications with the same content
156    stack_duplicates = true
157
158    # Hide the count of stacked notifications with the same content
159    hide_duplicate_count = false
160
161    # Display indicators for URLs (U) and actions (A).
162    show_indicators = yes
163
164    ### Icons ###
165
166    # Align icons left/right/off
167    icon_position = left
168
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.
172    min_icon_size = 0
173
174    # Scale larger icons down to this size, set to 0 to disable
175    max_icon_size = 50
176
177    # Paths to default icons.
178    icon_path = /usr/share/icons/Suru++-Dark/status/48@2x/:/usr/share/icons/Suru++-Dark/devices/64@2x/
179
180    ### History ###
181
182    # Should a notification popped up from history be sticky or timeout
183    # as if it would normally do.
184    sticky_history = yes
185
186    # Maximum amount of notifications kept in history
187    history_length = 50
188
189    ### Misc/Advanced ###
190
191    # dmenu path.
192    dmenu = /usr/bin/dmenu -p dunst:
193
194    # Browser for opening urls in context menu.
195    browser = /usr/bin/firefox-developer-edition -new-tab
196
197    # Always run rule-defined scripts, even if the notification is suppressed
198    always_run_script = true
199
200    # Define the title of the windows spawned by dunst
201    title = Dunst
202
203    # Define the class of the windows spawned by dunst
204    class = Dunst
205
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 = true
210
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
218    verbosity = mesg
219
220    # Define the corner radius of the notification window
221    # in pixel size. If the radius is 0, you have no rounded
222    # corners.
223    # The radius will be automatically lowered if it exceeds half of the
224    # notification height to avoid clipping text and/or icons.
225    corner_radius = 10
226
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
232
233    ### Legacy
234
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
238    # discouraged.
239    #
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
242    # layout changes.
243    force_xinerama = false
244
245    ### mouse
246
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
259
260# Experimental features that may or may not work correctly. Do not expect them
261# to have a consistent behaviour across releases.
262[experimental]
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
269
270[shortcuts]
271
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.
276
277    # Close all notifications.
278    close_all = mod4+n
279
280    # Redisplay last message(s).
281    # On the US keyboard layout "grave" is normally above TAB and left
282    # of "1". Make sure this key actually exists on your keyboard layout,
283    # e.g. check output of 'xmodmap -pke'
284    #history = mod2+shift+n
285
286    # Context menu.
287    context = mod4+shift+n
288
289[urgency_low]
290    # IMPORTANT: colors have to be defined in quotation marks.
291    # Otherwise the "#" and following would be interpreted as a comment.
292    background = "#282A36"
293    foreground = "#F8F8F2"
294    timeout = 0
295    # Icon for notifications with low urgency, uncomment to enable
296    #icon = /path/to/icon
297
298[urgency_normal]
299    background = "#282A36"
300    foreground = "#F8F8F2"
301    timeout = 0
302    # Icon for notifications with normal urgency, uncomment to enable
303    #icon = /path/to/icon
304
305[urgency_critical]
306    background = "#282A36"
307    foreground = "#F8F8F2"
308    timeout = 0
309    # Icon for notifications with critical urgency, uncomment to enable
310    #icon = /path/to/icon
311
312# Every section that isn't one of the above is interpreted as a rules to
313# override settings for certain messages.
314#
315# Messages can be matched by
316#    appname (discouraged, see desktop_entry)
317#    body
318#    category
319#    desktop_entry
320#    icon
321#    match_transient
322#    msg_urgency
323#    stack_tag
324#    summary
325#
326# and you can override the
327#    background
328#    foreground
329#    format
330#    frame_color
331#    fullscreen
332#    new_icon
333#    set_stack_tag
334#    set_transient
335#    timeout
336#    urgency
337#
338# Shell-like globbing will get expanded.
339#
340# Instead of the appname filter, it's recommended to use the desktop_entry filter.
341# GLib based applications export their desktop-entry name. In comparison to the appname,
342# the desktop-entry won't get localized.
343#
344# SCRIPTING
345# You can specify a script that gets run when the rule matches by
346# setting the "script" option.
347# The script will be called as follows:
348#   script appname summary body icon urgency
349# where urgency can be "LOW", "NORMAL" or "CRITICAL".
350#
351# NOTE: if you don't want a notification to be displayed, set the format
352# to "".
353# NOTE: It might be helpful to run dunst -print in a terminal in order
354# to find fitting options for rules.
355
356# Disable the transient hint so that idle_threshold cannot be bypassed from the
357# client
358#[transient_disable]
359#    match_transient = yes
360#    set_transient = no
361#
362# Make the handling of transient notifications more strict by making them not
363# be placed in history.
364#[transient_history_ignore]
365#    match_transient = yes
366#    history_ignore = yes
367
368# fullscreen values
369# show: show the notifications, regardless if there is a fullscreen window opened
370# delay: displays the new notification, if there is no fullscreen window active
371#        If the notification is already drawn, it won't get undrawn.
372# pushback: same as delay, but when switching into fullscreen, the notification will get
373#           withdrawn from screen again and will get delayed like a new notification
374#[fullscreen_delay_everything]
375#    fullscreen = delay
376#[fullscreen_show_critical]
377#    msg_urgency = critical
378#    fullscreen = show
379
380#[espeak]
381#    summary = "*"
382#    script = dunst_espeak.sh
383
384#[script-test]
385#    summary = "*script*"
386#    script = dunst_test.sh
387
388#[ignore]
389#    # This notification will not be displayed
390#    summary = "foobar"
391#    format = ""
392
393#[history-ignore]
394#    # This notification will not be saved in history
395#    summary = "foobar"
396#    history_ignore = yes
397
398#[skip-display]
399#    # This notification will not be displayed, but will be included in the history
400#    summary = "foobar"
401#    skip_display = yes
402
403#[signed_on]
404#    appname = Pidgin
405#    summary = "*signed on*"
406#    urgency = low
407#
408#[signed_off]
409#    appname = Pidgin
410#    summary = *signed off*
411#    urgency = low
412#
413#[says]
414#    appname = Pidgin
415#    summary = *says*
416#    urgency = critical
417#
418#[twitter]
419#    appname = Pidgin
420#    summary = *twitter.com*
421#    urgency = normal
422#
423#[stack-volumes]
424#    appname = "some_volume_notifiers"
425#    set_stack_tag = "volume"
426#
427# vim: ft=cfg