dunstrc.tmpl

  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    {{- if eq .theme_variant "light" }}
 68    frame_color = "#1E66F5"
 69    {{- end }}
 70    {{- if eq .theme_variant "dark" }}
 71    frame_color = "#8AADF4"
 72    {{- end }}
 73
 74    # Define a color for the separator.
 75    # possible values are:
 76    #  * auto: dunst tries to find a color fitting to the background;
 77    #  * foreground: use the same color as the foreground;
 78    #  * frame: use the same color as the frame;
 79    #  * anything else will be interpreted as a X color.
 80    separator_color = frame
 81
 82    # Sort messages by urgency.
 83    sort = yes
 84
 85    # Don't remove messages, if the user is idle (no mouse or keyboard input)
 86    # for longer than idle_threshold seconds.
 87    # Set to 0 to disable.
 88    # A client can set the 'transient' hint to bypass this. See the rules
 89    # section for how to disable this if necessary
 90    idle_threshold = 1
 91
 92    ### Text ###
 93
 94    font = {{ .font }}
 95
 96    # The spacing between lines.  If the height is smaller than the
 97    # font height, it will get raised to the font height.
 98    line_height = 0
 99
100    # Possible values are:
101    # full: Allow a small subset of html markup in notifications:
102    #        <b>bold</b>
103    #        <i>italic</i>
104    #        <s>strikethrough</s>
105    #        <u>underline</u>
106    #
107    #        For a complete reference see
108    #        <https://developer.gnome.org/pango/stable/pango-Markup.html>.
109    #
110    # strip: This setting is provided for compatibility with some broken
111    #        clients that send markup even though it's not enabled on the
112    #        server. Dunst will try to strip the markup but the parsing is
113    #        simplistic so using this option outside of matching rules for
114    #        specific applications *IS GREATLY DISCOURAGED*.
115    #
116    # no:    Disable markup parsing, incoming notifications will be treated as
117    #        plain text. Dunst will not advertise that it has the body-markup
118    #        capability if this is set as a global setting.
119    #
120    # It's important to note that markup inside the format option will be parsed
121    # regardless of what this is set to.
122    markup = full
123
124    # The format of the message.  Possible variables are:
125    #   %a  appname
126    #   %s  summary
127    #   %b  body
128    #   %i  iconname (including its path)
129    #   %I  iconname (without its path)
130    #   %p  progress value if set ([  0%] to [100%]) or nothing
131    #   %n  progress value if set without any extra characters
132    #   %%  Literal %
133    # Markup is allowed
134    format = "<b>%s</b>\n%b"
135
136    # Alignment of message text.
137    # Possible values are "left", "center" and "right".
138    alignment = left
139
140    # Vertical alignment of message text and icon.
141    # Possible values are "top", "center" and "bottom".
142    vertical_alignment = center
143
144    # Show age of message if message is older than show_age_threshold
145    # seconds.
146    # Set to -1 to disable.
147    show_age_threshold = 60
148
149    # Split notifications into multiple lines if they don't fit into
150    # geometry.
151    word_wrap = yes
152
153    # When word_wrap is set to no, specify where to make an ellipsis in long lines.
154    # Possible values are "start", "middle" and "end".
155    ellipsize = middle
156
157    # Ignore newlines '\n' in notifications.
158    ignore_newline = no
159
160    # Stack together notifications with the same content
161    stack_duplicates = true
162
163    # Hide the count of stacked notifications with the same content
164    hide_duplicate_count = false
165
166    # Display indicators for URLs (U) and actions (A).
167    show_indicators = yes
168
169    ### Icons ###
170
171    # Align icons left/right/off
172    icon_position = left
173
174    # Scale small icons up to this size, set to 0 to disable. Helpful
175    # for e.g. small files or high-dpi screens. In case of conflict,
176    # max_icon_size takes precedence over this.
177    min_icon_size = 0
178
179    # Scale larger icons down to this size, set to 0 to disable
180    max_icon_size = 50
181
182    # Paths to default icons.
183    icon_path = /usr/share/icons/Suru++-Dark/status/48@2x/:/usr/share/icons/Suru++-Dark/devices/64@2x/
184
185    ### History ###
186
187    # Should a notification popped up from history be sticky or timeout
188    # as if it would normally do.
189    sticky_history = yes
190
191    # Maximum amount of notifications kept in history
192    history_length = 50
193
194    ### Misc/Advanced ###
195
196    # dmenu path.
197    dmenu = /usr/bin/dmenu -p dunst:
198
199    # Browser for opening urls in context menu.
200    browser = /usr/bin/firefox-developer-edition -new-tab
201
202    # Always run rule-defined scripts, even if the notification is suppressed
203    always_run_script = true
204
205    # Define the title of the windows spawned by dunst
206    title = Dunst
207
208    # Define the class of the windows spawned by dunst
209    class = Dunst
210
211    # Print a notification on startup.
212    # This is mainly for error detection, since dbus (re-)starts dunst
213    # automatically after a crash.
214    startup_notification = true
215
216    # Manage dunst's desire for talking
217    # Can be one of the following values:
218    #  crit: Critical features. Dunst aborts
219    #  warn: Only non-fatal warnings
220    #  mesg: Important Messages
221    #  info: all unimportant stuff
222    # debug: all less than unimportant stuff
223    verbosity = mesg
224
225    # Define the corner radius of the notification window
226    # in pixel size. If the radius is 0, you have no rounded
227    # corners.
228    # The radius will be automatically lowered if it exceeds half of the
229    # notification height to avoid clipping text and/or icons.
230    corner_radius = 10
231
232    # Ignore the dbus closeNotification message.
233    # Useful to enforce the timeout set by dunst configuration. Without this
234    # parameter, an application may close the notification sent before the
235    # user defined timeout.
236    ignore_dbusclose = true
237
238    ### Legacy
239
240    # Use the Xinerama extension instead of RandR for multi-monitor support.
241    # This setting is provided for compatibility with older nVidia drivers that
242    # do not support RandR and using it on systems that support RandR is highly
243    # discouraged.
244    #
245    # By enabling this setting dunst will not be able to detect when a monitor
246    # is connected or disconnected which might break follow mode if the screen
247    # layout changes.
248    force_xinerama = false
249
250    ### mouse
251
252    # Defines list of actions for each mouse event
253    # Possible values are:
254    # * none: Don't do anything.
255    # * do_action: If the notification has exactly one action, or one is marked as default,
256    #              invoke it. If there are multiple and no default, open the context menu.
257    # * close_current: Close current notification.
258    # * close_all: Close all notifications.
259    # These values can be strung together for each mouse event, and
260    # will be executed in sequence.
261    mouse_left_click = close_current
262    mouse_middle_click = do_action, close_current
263    mouse_right_click = close_all
264
265# Experimental features that may or may not work correctly. Do not expect them
266# to have a consistent behaviour across releases.
267[experimental]
268    # Calculate the dpi to use on a per-monitor basis.
269    # If this setting is enabled the Xft.dpi value will be ignored and instead
270    # dunst will attempt to calculate an appropriate dpi value for each monitor
271    # using the resolution and physical size. This might be useful in setups
272    # where there are multiple screens with very different dpi values.
273    per_monitor_dpi = false
274
275[shortcuts]
276
277    # Shortcuts are specified as [modifier+][modifier+]...key
278    # Available modifiers are "ctrl", "mod1" (the alt-key), "mod2",
279    # "mod3" and "mod4" (windows-key).
280    # Xev might be helpful to find names for keys.
281
282    # Close all notifications.
283    close_all = mod4+n
284
285    # Redisplay last message(s).
286    # On the US keyboard layout "grave" is normally above TAB and left
287    # of "1". Make sure this key actually exists on your keyboard layout,
288    # e.g. check output of 'xmodmap -pke'
289    #history = mod2+shift+n
290
291    # Context menu.
292    context = mod4+shift+n
293
294{{- if eq .theme_variant "light" }}
295[urgency_low]
296    background = "#EFF1F5"
297    foreground = "#4C4F69"
298
299[urgency_normal]
300    background = "#EFF1F5"
301    foreground = "#4C4F69"
302
303[urgency_critical]
304    background = "#EFF1F5"
305    foreground = "#4C4F69"
306    frame_color = "#FE640B"
307{{- end }}
308{{- if eq .theme_variant "dark" }}
309[urgency_low]
310    background = "#24273A"
311    foreground = "#CAD3F5"
312
313[urgency_normal]
314    background = "#24273A"
315    foreground = "#CAD3F5"
316
317[urgency_critical]
318    background = "#24273A"
319    foreground = "#CAD3F5"
320    frame_color = "#F5A97F"
321{{- end }}
322
323# Every section that isn't one of the above is interpreted as a rules to
324# override settings for certain messages.
325#
326# Messages can be matched by
327#    appname (discouraged, see desktop_entry)
328#    body
329#    category
330#    desktop_entry
331#    icon
332#    match_transient
333#    msg_urgency
334#    stack_tag
335#    summary
336#
337# and you can override the
338#    background
339#    foreground
340#    format
341#    frame_color
342#    fullscreen
343#    new_icon
344#    set_stack_tag
345#    set_transient
346#    timeout
347#    urgency
348#
349# Shell-like globbing will get expanded.
350#
351# Instead of the appname filter, it's recommended to use the desktop_entry filter.
352# GLib based applications export their desktop-entry name. In comparison to the appname,
353# the desktop-entry won't get localized.
354#
355# SCRIPTING
356# You can specify a script that gets run when the rule matches by
357# setting the "script" option.
358# The script will be called as follows:
359#   script appname summary body icon urgency
360# where urgency can be "LOW", "NORMAL" or "CRITICAL".
361#
362# NOTE: if you don't want a notification to be displayed, set the format
363# to "".
364# NOTE: It might be helpful to run dunst -print in a terminal in order
365# to find fitting options for rules.
366
367# Disable the transient hint so that idle_threshold cannot be bypassed from the
368# client
369#[transient_disable]
370#    match_transient = yes
371#    set_transient = no
372#
373# Make the handling of transient notifications more strict by making them not
374# be placed in history.
375#[transient_history_ignore]
376#    match_transient = yes
377#    history_ignore = yes
378
379# fullscreen values
380# show: show the notifications, regardless if there is a fullscreen window opened
381# delay: displays the new notification, if there is no fullscreen window active
382#        If the notification is already drawn, it won't get undrawn.
383# pushback: same as delay, but when switching into fullscreen, the notification will get
384#           withdrawn from screen again and will get delayed like a new notification
385#[fullscreen_delay_everything]
386#    fullscreen = delay
387#[fullscreen_show_critical]
388#    msg_urgency = critical
389#    fullscreen = show
390
391#[espeak]
392#    summary = "*"
393#    script = dunst_espeak.sh
394
395#[script-test]
396#    summary = "*script*"
397#    script = dunst_test.sh
398
399#[ignore]
400#    # This notification will not be displayed
401#    summary = "foobar"
402#    format = ""
403
404#[history-ignore]
405#    # This notification will not be saved in history
406#    summary = "foobar"
407#    history_ignore = yes
408
409#[skip-display]
410#    # This notification will not be displayed, but will be included in the history
411#    summary = "foobar"
412#    skip_display = yes
413
414#[signed_on]
415#    appname = Pidgin
416#    summary = "*signed on*"
417#    urgency = low
418#
419#[signed_off]
420#    appname = Pidgin
421#    summary = *signed off*
422#    urgency = low
423#
424#[says]
425#    appname = Pidgin
426#    summary = *says*
427#    urgency = critical
428#
429#[twitter]
430#    appname = Pidgin
431#    summary = *twitter.com*
432#    urgency = normal
433#
434#[stack-volumes]
435#    appname = "some_volume_notifiers"
436#    set_stack_tag = "volume"
437#
438# vim: ft=cfg