dunst(1) - f34

1dunst(1)                        Dunst Reference                       dunst(1)
2
3
4

NAME

6       dunst - A customizable and lightweight notification-daemon
7

SYNOPSIS

9       dunst [-conf file] [-font font] [-geometry geom] [-format fmt] [-follow
10       mode] [-monitor n] [-history_length n] ...
11

DESCRIPTION

13       Dunst is a highly configurable and lightweight notification daemon.
14

COMMAND LINE OPTIONS

16       -h/--help
17           List all command line flags
18
19       -conf/-config file
20           Use alternative config file.
21
22       -v/--version
23           Print version information.
24
25       -print
26           Print notifications to stdout. This might be useful for logging,
27           setting up rules or using the output in other scripts.
28
29       -SETTING [value]
30           Where SETTING can be any setting that's available in the global
31           section of the configuration file. See dunst(5) for possible
32           settings.
33
34           Each configuration option in the global section can be overridden
35           from the command line by adding a single dash in front of it's
36           name.  For example the font option can be overridden by running
37
38               $ dunst -font "LiberationSans Mono 4"
39
40           Configuration options that take boolean values can only currently
41           be set to "true" through the command line via the same method. e.g.
42
43               $ dunst -shrink
44
45           This is a known limitation of the way command line parameters are
46           parsed and will be changed in the future.
47

CONFIGURATION

49       An example configuration file is included (usually /etc/dunst/dunstrc).
50       Note: this was previously /usr/share/dunst/dunstrc.  Before using
51       dunst, copy this file to ~/.config/dunst/dunstrc and edit it
52       accordingly. See dunst(5) for all possible settings.
53
54   NOTIFY-SEND
55       dunst is able to get different colors for a message via notify-send.
56       In order to do that you have to add a hint via the -h option.  The
57       progress value can be set with a hint, too.
58
59       notify-send -h string:fgcolor:#ff4444
60       notify-send -h string:bgcolor:#4444ff -h string:fgcolor:#ff4444 -h
61       string:frcolor:#44ff44
62       notify-send -h int:value:42 "Working ..."
63

ACTIONS

65       Dunst allows notifiers (i.e.: programs that send the notifications) to
66       specify actions. Dunst has support for both displaying indicators for
67       these, and interacting with these actions.
68
69       If "show_indicators" is true and a notification has an action, an "(A)"
70       will be prepended to the notification format. Likewise, an "(U)" is
71       prepended to notifications with URLs. It is possible to interact with
72       notifications that have actions regardless of this setting, though it
73       may not be obvious which notifications HAVE actions.
74
75       The "context" keybinding is used to interact with these actions, by
76       showing a menu of possible actions. This feature requires "dmenu" or a
77       dmenu drop-in replacement present. It is preferred to set this
78       keybinding with your window manager or desktop envirorment and let it
79       execute "dunsctl context". Another option is to set this keybinding in
80       your dunstrc, but this is soon to be deprecated (and doesn't work on
81       Wayland).
82
83       Alternatively, you can invoke an action with a middle click on the
84       notification.  If there is exactly one associated action, or one is
85       marked as default, that one is invoked. If there are multiple, the
86       context menu is shown. The same applies to URLs when there are no
87       actions. You can change the mouse button to right click by setting
88       "mouse_right_click = close_all" in your dunstrc.
89

MISCELLANEOUS

91       Dunst can be paused via the `dunstctl set-paused true` command. To
92       unpause dunst use `dunstctl set-paused false`.  Alternatively you can
93       send SIGUSR1 and SIGUSR2 to pause and unpause respectively. For
94       Example:
95
96       killall -SIGUSR1 dunst # pause
97       killall -SIGUSR2 dunst # resume
98
99       When paused dunst will not display any notifications but keep all
100       notifications in a queue.  This can for example be wrapped around a
101       screen locker (i3lock, slock) to prevent flickering of notifications
102       through the lock and to read all missed notifications after returning
103       to the computer.
104

FILES

106       These are the places where dunst will look for a configuration file.
107       They are listed here in order and if dunst finds one of them, it will
108       stop looking for more.
109
110       $XDG_CONFIG_HOME/dunst/dunstrc
111
112       $HOME/.config/dunst/dunstrc
113
114       -or-
115
116       $XDG_CONFIG_HOME/dunst/dunstrc
117
118       /etc/xdg/dunst/dunstrc
119
120       /etc/dunst/dunstrc
121           This is where the default config file is located
122

AUTHORS

124       Written by Sascha Kruse <knopwob@googlemail.com>
125

REPORTING BUGS

127       Bugs and suggestions should be reported on GitHub at
128       https://github.com/dunst-project/dunst/issues
129

COPYRIGHT

131       Copyright 2013 Sascha Kruse and contributors (see LICENSE for licensing
132       information)
133
134       If you feel that copyrights are violated, please send me an email.
135