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

NAME

6       dunst - A customizable and lightweight notification-daemon
7

SYNOPSIS

9       dunst [-conf file] [-verbosity v] [-print] [--startup-notification]
10

DESCRIPTION

12       Dunst is a highly configurable and lightweight notification daemon.
13
14   Autostarting dunst
15       On most installations, dunst should be able to automatically be started
16       by D-Bus when a notification is sent. This is not recommended when
17       multiple notification deamons are installed, because D-Bus will not
18       know which one to start.  Other ways of autostarting dunst include
19       starting dunst with your desktop environment or window manager's
20       autostart functionality or via the provided systemd service.
21

COMMAND LINE OPTIONS

23       -h/--help
24           List all command line flags
25
26       -conf/-config file
27           Use alternative config file.  This disables the search for other
28           config files.  If it cannot be opened, dunst will issue a warning
29           and fall back on its internal defaults.  (Hint: `dunst -conf -
30           </dev/null` can be used to enforce the defaults, i.e. for testing)
31
32       -v/--version
33           Print version information.
34
35       -verbosity (values: 'crit', 'warn', 'mesg', 'info', 'debug' default
36       'mesg')
37           Do not display log messages, which have lower precedence than
38           specified verbosity. This won't affect printing notifications on
39           the terminal. Use the '-print' option for this.
40
41       -print
42           Print notifications to stdout. This might be useful for logging,
43           setting up rules or using the output in other scripts.
44
45       --startup_notification (values: [true/false], default: false)
46           Display a notification on startup.
47

CONFIGURATION

49       A default configuration file is included (usually
50       /etc/xdg/dunst/dunstrc) and serves as the least important configuration
51       file. Note: this was previously /usr/share/dunst/dunstrc. You can edit
52       this file to change the system-wide defaults or copy it to a more
53       important location to override its settings. See the FILES section for
54       more details on where dunst searches for its configuration files and
55       how settings get applied.
56
57       See dunst(5) for all possible settings.
58
59   NOTIFY-SEND
60       dunst is able to get different colors for a message via notify-send.
61       In order to do that you have to add a hint via the -h option.  The
62       progress value can be set with a hint, too.
63
64       notify-send -h string:fgcolor:#ff4444
65       notify-send -h string:bgcolor:#4444ff -h string:fgcolor:#ff4444 -h
66       string:frcolor:#44ff44
67       notify-send -h int:value:42 "Working ..."
68

MISCELLANEOUS

70       Dunst can be paused via the `dunstctl set-paused true` command. To
71       unpause dunst use `dunstctl set-paused false`.  Another way is to send
72       SIGUSR1 and SIGUSR2 to pause and unpause respectively. Pausing using
73       dunstctl is recommended over using signals, because the meaning of the
74       signals isn't stable and might change in the future.
75
76       When paused, dunst won't display any notifications, but keeps all
77       notifications in a queue. This can for example be wrapped around a
78       screen locker (i3lock, slock) to prevent flickering of notifications
79       through the lock, and to read all missed notifications after returning
80       to the computer.
81

FILES

83       These are the base directories dunst searches for configuration files
84       in descending order of imortance:
85
86       $XDG_CONFIG_HOME
87               This is the most important directory. ("$HOME/.config" if unset
88               or empty)
89
90       $XDG_CONFIG_DIRS
91               This, like $PATH for instance, is a :-separated list of base
92               directories in descending order of importance.  (/etc/xdg if
93               unset or empty)
94
95       Dunst will search these directories for the following relative file
96       paths:
97
98       dunst/dunstrc
99               This is the base config and as such the least important in a
100               particular base directory.
101
102       dunst/dunstrc.d/*.conf
103               These are "drop-ins" (mind the ".d" suffix of the directory).
104               They are more important than the base dunstrc in the parent
105               directory, as they are considered to be small snippets to
106               override settings.  The last in lexical order is the most
107               important one, so you can easily change the order by renaming
108               them.  A common approach to naming drop-ins is to prefix them
109               with numbers, i.e.:
110
111                   00-least-important.conf
112                   01-foo.conf
113                   20-bar.conf
114                   99-most-important.conf
115
116               Only files with the .conf suffix will be read.
117
118       Only settings from the last base config the corresponding drop-ins get
119       applied.  So if a dunstrc is first found in ~/.config/dunst/dunstrc,
120       drop-ins will be searched in ~/.config/dunst/dunstrc.d/*. Settings in
121       more important files override those in less important ones.
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
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

SEE ALSO

137       dunst(5), dunstctl(1), dmenu(1), notify-send(1)
138
139
140
1411.9.2                             2023-07-19                          dunst(1)
Impressum