@@ 3,6 3,7 @@
# SPDX-FileCopyrightText: 2022 Richard Brežák <richard@brezak.sk>
#
# SPDX-License-Identifier: LGPL-3.0-or-later
+# See dunst(5) for all configuration options
[global]
### Display ###
@@ 23,54 24,89 @@
# will be ignored.
follow = none
- # 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.
- geometry = "300x5-30+20"
-
- # Show how many messages are currently hidden (because of geometry).
- indicate_hidden = yes
+ ### Geometry ###
+
+ # dynamic width from 0 to 300
+ # width = (0, 300)
+ # constant width of 300
+ width = 300
+
+ # The maximum height of a single notification, excluding the frame.
+ height = 50
+
+ # Position the notification in the top right corner
+ origin = top-right
+
+ # Offset from the origin
+ offset = 0x15
+
+ # Scale factor. It is auto-detected if value is 0.
+ scale = 0
+
+ # Maximum number of notification (0 means no limit)
+ notification_limit = 20
+
+ ### Progress bar ###
+
+ # Turn on the progess bar. It appears when a progress hint is passed with
+ # for example dunstify -h int:value:12
+ progress_bar = true
- # Shrink window if it's smaller than the width. Will be ignored if
- # width is 0.
- shrink = no
+ # Set the progress bar height. This includes the frame, so make sure
+ # it's at least twice as big as the frame width.
+ progress_bar_height = 10
+
+ # Set the frame width of the progress bar
+ progress_bar_frame_width = 1
+
+ # Set the minimum width for the progress bar
+ progress_bar_min_width = 150
+
+ # Set the maximum width for the progress bar
+ progress_bar_max_width = 300
+
+ # Corner radius for the progress bar. 0 disables rounded corners.
+ progress_bar_corner_radius = 0
+
+ # Corner radius for the icon image.
+ icon_corner_radius = 0
+
+ # Show how many messages are currently hidden (because of
+ # notification_limit).
+ indicate_hidden = yes
# 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.).
+ # present (e.g. xcompmgr, compiz, etc.). (X11 only)
transparency = 0
- # 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.
- notification_height = 0
-
# Draw a line of "separator_height" pixel height between two
# notifications.
# Set to 0 to disable.
- separator_height = 2
+ # If gap_size is greater than 0, this setting will be ignored.
+ separator_height = 1
# Padding between text and separator.
- padding = 8
+ padding = 1
# Horizontal padding.
- horizontal_padding = 8
+ horizontal_padding = 4
+
+ # Padding between text and icon.
+ text_icon_padding = 0
# Defines width in pixels of frame around the notification window.
# Set to 0 to disable.
- frame_width = 3
+ frame_width = 1
# Defines color of the frame around the notification window.
- frame_color = "#aaaaaa"
+ frame_color = "#555555"
+
+ # Size of gap to display between notifications - requires a compositor.
+ # If value is greater than 0, separator_height will be ignored and a border
+ # of size frame_width will be drawn around each notification instead.
+ # Click events on gaps do not currently propagate to applications below.
+ gap_size = 0
# Define a color for the separator.
# possible values are:
@@ 88,11 124,11 @@
# 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
- idle_threshold = 120
+ # idle_threshold = 120
### Text ###
- font = Monospace 8
+ font = Fixed 8
# The spacing between lines. If the height is smaller than the
# font height, it will get raised to the font height.
@@ 106,7 142,7 @@
# <u>underline</u>
#
# For a complete reference see
- # <https://developer.gnome.org/pango/stable/pango-Markup.html>.
+ # <https://docs.gtk.org/Pango/pango_markup.html>.
#
# strip: This setting is provided for compatibility with some broken
# clients that send markup even though it's not enabled on the
@@ 132,7 168,7 @@
# %n progress value if set without any extra characters
# %% Literal %
# Markup is allowed
- format = "<b>%s</b>\n%b"
+ format = "%a: <b>%s</b>\n%b"
# Alignment of message text.
# Possible values are "left", "center" and "right".
@@ 147,11 183,7 @@
# Set to -1 to disable.
show_age_threshold = 60
- # Split notifications into multiple lines if they don't fit into
- # geometry.
- word_wrap = yes
-
- # When word_wrap is set to no, specify where to make an ellipsis in long lines.
+ # Specify where to make an ellipsis in long lines.
# Possible values are "start", "middle" and "end".
ellipsize = middle
@@ 169,18 201,27 @@
### Icons ###
- # Align icons left/right/off
+ # Recursive icon lookup. You can set a single theme, instead of having to
+ # define all lookup paths.
+ enable_recursive_icon_lookup = true
+
+ # Set icon theme (only used for recursive icon lookup)
+ icon_theme = Adwaita
+ # You can also set multiple icon themes, with the leftmost one being used first.
+ # icon_theme = "Adwaita, breeze"
+
+ # Align icons left/right/top/off
icon_position = off
# Scale small icons up to this size, set to 0 to disable. Helpful
# for e.g. small files or high-dpi screens. In case of conflict,
# max_icon_size takes precedence over this.
- min_icon_size = 0
+ min_icon_size = 32
# Scale larger icons down to this size, set to 0 to disable
- max_icon_size = 32
+ max_icon_size = 128
- # Paths to default icons.
+ # Paths to default icons (only neccesary when not using recursive icon lookup)
icon_path = /usr/share/icons/gnome/16x16/status/:/usr/share/icons/gnome/16x16/devices/
### History ###
@@ 198,7 239,7 @@
dmenu = /usr/bin/dmenu -p dunst:
# Browser for opening urls in context menu.
- browser = /usr/bin/firefox -new-tab
+ browser = /usr/bin/xdg-open
# Always run rule-defined scripts, even if the notification is suppressed
always_run_script = true
@@ 209,20 250,6 @@
# Define the class of the windows spawned by dunst
class = Dunst
- # Print a notification on startup.
- # This is mainly for error detection, since dbus (re-)starts dunst
- # automatically after a crash.
- startup_notification = false
-
- # 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
- # debug: all less than unimportant stuff
- verbosity = mesg
-
# Define the corner radius of the notification window
# in pixel size. If the radius is 0, you have no rounded
# corners.
@@ 230,6 257,22 @@
# notification height to avoid clipping text and/or icons.
corner_radius = 0
+ # Ignore the dbus closeNotification message.
+ # Useful to enforce the timeout set by dunst configuration. Without this
+ # parameter, an application may close the notification sent before the
+ # user defined timeout.
+ ignore_dbusclose = false
+
+ ### Wayland ###
+ # These settings are Wayland-specific. They have no effect when using X11
+
+ # Uncomment this if you want to let notications appear under fullscreen
+ # applications (default: overlay)
+ # layer = top
+
+ # Set this to true to use X11 output on Wayland.
+ force_xwayland = false
+
### Legacy
# Use the Xinerama extension instead of RandR for multi-monitor support.
@@ 244,15 287,21 @@
### mouse
- # Defines action of mouse event
+ # Defines list of actions for each 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.
+ # * do_action: Invoke the action determined by the action_name rule. If there is no
+ # such action, open the context menu.
+ # * open_url: If the notification has exactly one url, open it. If there are multiple
+ # ones, open the context menu.
# * close_current: Close current notification.
# * close_all: Close all notifications.
+ # * context: Open context menu for the notification.
+ # * context_all: Open context menu for all notifications.
+ # These values can be strung together for each mouse event, and
+ # will be executed in sequence.
mouse_left_click = close_current
- mouse_middle_click = do_action
+ mouse_middle_click = do_action, close_current
mouse_right_click = close_all
# Experimental features that may or may not work correctly. Do not expect them
@@ 265,51 314,30 @@
# where there are multiple screens with very different dpi values.
per_monitor_dpi = false
-[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 = ctrl+space
-
- # Close all notifications.
- close_all = ctrl+shift+space
-
- # 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'
- history = ctrl+grave
-
- # Context menu.
- context = ctrl+shift+period
[urgency_low]
# IMPORTANT: colors have to be defined in quotation marks.
# Otherwise the "#" and following would be interpreted as a comment.
- background = "#222222"
- foreground = "#888888"
+ background = "#000000"
+ foreground = "#FFFFFF"
timeout = 10
# Icon for notifications with low urgency, uncomment to enable
- #icon = /path/to/icon
+ #default_icon = /path/to/icon
[urgency_normal]
- background = "#285577"
- foreground = "#ffffff"
+ background = "#000000"
+ foreground = "#FFFFFF"
timeout = 10
# Icon for notifications with normal urgency, uncomment to enable
- #icon = /path/to/icon
+ #default_icon = /path/to/icon
[urgency_critical]
- background = "#900000"
- foreground = "#ffffff"
- frame_color = "#ff0000"
+ background = "#000000"
+ foreground = "#FFFFFF"
+ frame_color = "#FF0000"
timeout = 0
# Icon for notifications with critical urgency, uncomment to enable
- #icon = /path/to/icon
+ #default_icon = /path/to/icon
# Every section that isn't one of the above is interpreted as a rules to
# override settings for certain messages.
@@ 334,8 362,17 @@
# new_icon
# set_stack_tag
# set_transient
+# set_category
# timeout
# urgency
+# icon_position
+# skip_display
+# history_ignore
+# action_name
+# word_wrap
+# ellipsize
+# alignment
+# hide_text
#
# Shell-like globbing will get expanded.
#
@@ 350,8 387,6 @@
# script appname summary body icon urgency
# where urgency can be "LOW", "NORMAL" or "CRITICAL".
#
-# NOTE: if you don't want a notification to be displayed, set the format
-# to "".
# NOTE: It might be helpful to run dunst -print in a terminal in order
# to find fitting options for rules.
@@ 390,7 425,7 @@
#[ignore]
# # This notification will not be displayed
# summary = "foobar"
-# format = ""
+# skip_display = true
#[history-ignore]
# # This notification will not be saved in history
@@ 426,4 461,4 @@
# appname = "some_volume_notifiers"
# set_stack_tag = "volume"
#
-# vim: ft=cfg
+# vim: ft=cfg<
\ No newline at end of file