dunst(1) - f35

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 /etc/dunst/dunstrc)
50       and serves as the least important configuration file. Note: this was
51       previously /usr/share/dunst/dunstrc. You can edit this file to change
52       the system-wide defaults or copy it to a more important location to
53       override its settings. See the FILES section for more details on where
54       dunst searches for its configuration files and how settings get
55       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`.  Alternatively you can
72       send SIGUSR1 and SIGUSR2 to pause and unpause respectively. For
73       Example:
74
75       killall -SIGUSR1 dunst # pause
76       killall -SIGUSR2 dunst # resume
77
78       When paused dunst will not display any notifications but keep all
79       notifications in a queue.  This can for example be wrapped around a
80       screen locker (i3lock, slock) to prevent flickering of notifications
81       through the lock and to read all missed notifications after returning
82       to the computer.
83

FILES

85       These are the base directories dunst searches for configuration files
86       in descending order of imortance:
87
88           $XDG_CONFIG_HOME ($HOME/.config if unset or empty)
89
90           $XDG_CONFIG_DIRS (:-separated list of base directories in
91           descending order of importance; /etc if unset or empty)
92
93       Dunst will search these directories for the following relative path:
94
95           dunst/dunstrc
96
97       All settings from all files get applied. Settings in more important
98       files override those in less important ones. Settings not present in
99       more imortant files are taken from a less important one or from the
100       internal defaults if they are not found in any file.
101
102       This is where the default (least important) config file is located:
103           /etc/dunst/dunstrc
104

AUTHORS

106       Written by Sascha Kruse <knopwob@googlemail.com>
107

REPORTING BUGS

109       Bugs and suggestions should be reported on GitHub at
110       https://github.com/dunst-project/dunst/issues
111

COPYRIGHT

113       Copyright 2013 Sascha Kruse and contributors (see LICENSE for licensing
114       information)
115
116       If you feel that copyrights are violated, please send me an email.
117