dunst(5) Dunst Reference dunst(5) (NAME) dunstrc - dunst (DESCRIPTION) ini . () . - . . <> dunst . (rules) . . (filtering) (modifying) . . . . <> : . (RULES) . <> . . . (Global section) default_pause_level (: [0-100], : 0) dunst . (urgency) . override_pause_level . monitor (: 0) 0 . follow . follow (: [none/mouse/keyboard], : none) . none monitor (override) . (Wayland) . . . none monitor . mouse . keyboard . enable_posix_regex (: false) true () POSIX . POSIX : https://en.m.wikibooks.org/wiki/Regular_Expressions/POSIX-Extended_Regular_Expressions. false ( ) dunst fnmatch(3) . Dunst fnmatch . POSIX . POSIX fnmatch(3) POSIX <<*>> <<.*>> (wildcards) POSIX . "abc" "abc" "abcdef" . geometry . width height origin notification_limit offset . geometry : geometry = x+ ( ): width = height = offset = origin = top-right # top-left width . . . : width = 300 # width = (0, 300) # dunst . ( 10000). height . . . : height = 300 # height = (0, 300) # . v1.11 dunst height (0, value) . notification_limit (: 20) . . 0 . indicate_hidden true . indicate_hidden . origin (: top-right) . offset . : top-left top-center top-right bottom-left bottom-center bottom-right left-center center right-center offset (: (horizontal, vertical), : (10, 50)) () origin. . : origin = top-right offset = (10, 300) # v1.11 dunst NxN ( X Y). . offset = 10x300 scale (: 0) ( X11) HiDPI . . . . 0 . progress_bar (: [true/false], : true) (hint) dunst ( NOTIFY-SEND ) . false . progress_bar_horizontal_alignment (: [left/center/right], : center) . horizontal_padding . progress_bar_height (: 10) . . . progress_bar_min_width (: 150) . . progress_bar_max_width (: 300) . . progress_bar_frame_width (: 1) . . progress_bar_corner_radius (: 0) . . 0 . progress_bar_corners none . progress_bar_corners (: all) . progress_bar_corner_radius 0 . corners . icon_corner_radius (: 0) . . 0 . icon_corners none . icon_corners (: all) . icon_corner_radius 0 . corners . indicate_hidden (: [true/false], : true) true ( notification_limit ) . notification_limit . transparency (: 0) ( X11) . . (COLORS) . COLORS . . separator_height (: 2) 0 . gap_size 0 . padding (: 8) / . horizontal_padding (: 8) . text_icon_padding (: 0) ( ) . horizontal_padding . : text_icon_padding=10 horizontal_padding=10 : text_icon_padding=0 horizontal_padding=10 frame_width (: 3) . 0 . gap_size (: 0) () . 0 separator_height frame_width . . separator_color (: [auto/foreground/frame/#RRGGBB], : frame) . auto . foreground . frame . COLORS . sort (: [true/false/id/urgency_ascending/urgency_descending/update], : true) true urgency_descending : (critical) (normal) (low). false id (id) . urgency_ascending : . update update_time . sort update stack_duplicates true . . idle_threshold (: 0) (idle) . (TIME FORMAT) . 0 . (transient) . <> . : xwayland . layer (: [bottom/top/overlay], : overlay) ( ) dunst . overlay top . bottom . force_xwayland (: [true/false], : false) ( ) X11 . . dunst X11 . font (: "Monospace 8") . . . Pango . : https://docs.gtk.org/Pango/type_func.FontDescription.from_string.html. line_height (: 0) . 0 . format (: "%s\n%b") . markup . (&) <<&>> (escape) . <<\n>> <<\t>> . . . %a (appname) %s (summary) %b (body) %c (category) %S (stack_tag) %i ( ) %I ( ) %p ([ 0%] [100%]) %n %% % ( ) . vertical_alignment (: [top/center/bottom], : center) . show_age_threshold (: 60) . TIME FORMAT . -1 . ignore_newline (: [true/false], : false) true . stack_duplicates (: [true/false], : true) true (stack) . . hide_duplicate_count (: [true/false], : false) . show_indicators (: [true/false], : true) (actions) / . ACTIONS . icon_path (: "/usr/share/icons/gnome/16x16/status/:/usr/share/icons/gnome/16x16/devices/") . Dunst . enable_recursive_icon_lookup . icon_path . icon_theme (: "Adwaita", : "Adwaita, breeze") . . Breeze Dark /usr/share/icons/breeze-dark . breeze-dark . . . Dunst XDG_DATA_HOME/icons $XDG_DATA_DIRS/icons : https://specifications.freedesktop.org/icon-theme-spec/icon-theme-spec-latest.html. . . enable_recursive_icon_lookup . enable_recursive_icon_lookup (: false) . . icon_path . icon_path . . icon_theme . enable_recursive_icon_lookup [global] true . . sticky_history (: [true/false], : true) true . history_length (: 20) . . HISTORY . dmenu (: "/usr/bin/dmenu -p dunst") (context menu) . dmenu dmenu . browser (: "/usr/bin/xdg-open") (URL) . . always_run_script (: [true/false] : true] "format = """ . SCRIPTING . title (: "Dunst") ( X11) ( _NET_WM_NAME) dunst . . class (: "Dunst") ( X11) ( WM_CLASS) dunst . . force_xinerama (: [true/false], : false) ( X11) Xinerama RandR . nVidia RandR RandR . dunst follow . corner_radius (: 0) . 0 . . ( gap_size ). . corners none . corners (: [none/all/bottom-right/bottom-left/top-right/top-left/top/bottom/left/right], : all) . 0 . mouse_[left/middle/right]_click (: [none/do_action/close_current/close_all/context/context_all]) . . . : o "mouse_left_click=close_current" o "mouse_middle_click=do_action, remove_current" o "mouse_right_click=close_all" none . do_action action_name . . open_url . . close_current . close_all . context . context_all . ignore_dbusclose (: false) CloseNotification . dunst . . override_pause_level (: [0-100], : 0) override_pause_level . 0 . override_pause_level 60 dunst 60 . dunst ( override_pause_level >= 60) . ( X11) (Keyboard shortcuts (X11 only)) : "Modifier+key" (modifier) ctrl mod1 mod2 mod3 mod4 key . global . dunstctl(1) . X . close . close_all . history . context . (Urgency sections) (low normal critical) . background foreground highlight timeout frame_color icon . urgency_low urgency_normal urgency_critical (low) (normal) (critical). . dunst . (RULES) (#328) . (Experimental section) per_monitor_dpi (: false) DPI . X11 . pause_on_mouse_over (: false) . Wayland . enable_pcre_regex (: false) PCRE . https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions . enable_posix_regex . DUNSTCTL (DUNSTCTL) dunst . . dunstctl(1) . (HISTORY) Dunst ( history_length) . dunstctl history ( ) ( dunstctl(1) ). sticky_history . . - (FILO) . (WAYLAND) Dunst 1.6.0 . Wayland X11 . . dunst dunstctl . dunst . Dunst . ( fullscreen ). layer = overlay . XWayland . . X11 . force_xwayland = true . dunst (status bar) X11 . . . . dunst layer shell <> . / . (RULES) . . . 'global' . 'urgency_low', 'urgency_normal' 'urgency_critical' . : . . . : . filtering . . enable_posix_regex true . POSIX : https://en.m.wikibooks.org/wiki/Regular_Expressions/POSIX-Extended_Regular_Expressions. enable_posix_regex . . (globbing) . (AND ). notify-send : appname="notify-send" . "appname" ( desktop_entry ) . (locale) . "desktop_entry" . "body" "category" . https://specifications.freedesktop.org/notification-spec/latest/categories.html . "desktop_entry" GLib desktop-entry . appname desktop-entry () . "icon" . . icon . "match_transient" . "set_transient" . "match_dbus_timeout" . "override_dbus_timeout" . "msg_urgency" . . "stack_tag" . set_stack_tag . "summary" <<>> . modifying . : "background" . COLORS . "foreground" . COLORS . "highlight" . . COLORS . ( ) . "format" "format" . "frame_color" . COLORS . "fullscreen" (: [delay/show/pushback/suppress], : show) . show . delay: . pushback delay . suppress . . pushback . Wayland follow mouse keyboard dunst (delay) (pushback) . . git sway . layer Wayland . "min_icon_size" (: 32) . . . ( enable_recursive_icon_lookup ) . icon_position off . "max_icon_size" (: 128) . . . 0 . min_icon_size max_icon_size . icon_position off . "new_icon" . dunstify . wordexp(3) . "icon_position" (: [left/right/top/off], : left) . off . "default_icon" . dunstify . wordexp(3) . "set_stack_tag" () appid . . 'synchronous' 'private-synchronous' 'x-canonical-private-synchronous' 'x-dunst-stack-tag' . "set_transient" . idle_threshold . __ 'transient' . "set_category" . https://specifications.freedesktop.org/notification-spec/latest/categories.html . "timeout" "timeout" . "override_dbus_timeout" . "timeout" . "urgency" . : *_urgency . . "msg_urgency" . "override_pause_level" override_pause_level . "skip_display" true . "history_ignore" true . "action_name" (: "default") do_action . . "word_wrap" (: [true/false], : true) . true . ellipsize . "ellipsize" (: [start/middle/end], : middle) . "alignment" (: [left/center/right], : left) . "hide_text" (: [true/false], : false) true . . ( ) . "markup" (: [full/strip/no], : no) (markup) . format . : full html : https://docs.gtk.org/Pango/pango_markup.html . strip . Dunst (strip) . RULES . no . dunst . (SCRIPTING) 'script' . . : DUNST_APP_NAME DUNST_SUMMARY DUNST_BODY DUNST_ICON_PATH DUNST_URGENCY DUNST_ID DUNST_PROGRESS DUNST_CATEGORY DUNST_STACK_TAG DUNST_URLS DUNST_TIMEOUT DUNST_TIMESTAMP DUNST_DESKTOP_ENTRY. . : appname summary body icon_path urgency. DUNST_ICON_PATH icon_path ( ). DUNST_URGENCY urgency "LOW" "NORMAL" "CRITICAL" . DUNST_URLS . . always_run_script true . script wordexp(3) . PATH . (COLORS) #RGB #RRGGBB . #RGBA #RRGGBBAA . : '#' () . : separator_color="#123456" NOTIFY-SEND (NOTIFY-SEND HINTS) Dunst notify-send . -h (hint) . . : Dunstify notify-send . . RULES . fgcolor (: string) . bgcolor (: string) . frcolor (: string) . hlcolor (: string string) . value (: int uint) . image-path (: string) . . image_path . image-data (: variant) . image_data icon_data . category (: string) . desktop-entry (: string) (desktop entry). transient (: int boolean) . x-dunst-stack-tag (: string) . . x-canonical-private-synchronous (: string) x-dunst-stack-tag. : notify-send -h string:fgcolor:#ff4444 "" notify-send -h string:bgcolor:#4444ff -h string:fgcolor:#ff4444 -h string:frcolor:#44ff44 ":)" notify-send -h int:value:42 " ..." notify-send -h string:x-canonical-private-synchronous:volume "" (ACTIONS) Dunst ( ) . Dunst . "show_indicators" true <<(A)>> . <<(U)>> . . <> . <> dmenu . . . . . (TIME FORMAT) . ("s") . dunst "ms" () "s" () "m" () "h" () "d" (). : "1000ms" "10m". (BUGS) https://github.com/dunst-project/dunst/issues . (COPYRIGHT) 2011-2014 Sascha Kruse 2014-2026 Dunst Dunst - BSD LICENSE . . (SEE ALSO) dunst(1) dunstctl(1) dmenu(1) notify-send(1) dunstify(1) 1.13.2 (2026-03-18) 2026-08-10 dunst(5)