1dunst(1) Dunst Reference dunst(1)
2
6 dunst - A customizable and lightweight notification-daemon
7
9 dunst [-conf file] [-verbosity v] [-print] [--startup-notification]
10
12 Dunst is a highly configurable and lightweight notification daemon.
13 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
23 -h/--help
24 List all command line flags
25 -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 -v/--version
33 Print version information.
34 -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 -print
42 Print notifications to stdout. This might be useful for logging,
43 setting up rules or using the output in other scripts.
44 --startup_notification (values: [true/false], default: false)
46 Display a notification on startup.
47
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 See dunst(5) for all possible settings.
58 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 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
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 is not be stable and might change in the future.
75 When paused dunst will not display any notifications but keep 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
83 These are the base directories dunst searches for configuration files
84 in descending order of imortance:
85 $XDG_CONFIG_HOME
87 This is the most important directory. ("$HOME/.config" if unset
88 or empty)
89 $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 Dunst will search these directories for the following relative file
96 paths:
97 dunst/dunstrc
99 This is the base config and as such the least important in a
100 particular base directory.
101 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 00-least-important.conf
112 01-foo.conf
113 20-bar.conf
114 99-most-important.conf
115 Only files with the .conf suffix will be read.
117 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
124 Written by Sascha Kruse <knopwob@googlemail.com>
125
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 If you feel that copyrights are violated, please send me an email.
135
137 dunst(5), dunstctl(1), dmenu(1), notify-send(1)
1381.9.0 2022-06-27 dunst(1)