NAME¶
dunst - dmenu-ish universal notification system
SYNOPSIS¶
dunst [-geometry geom] [-fn font] [-nf/nb/lf/lb/cf/cb color] [-to/nto/lto/cto
secs] [-format fmt] [-key key] [-mod mod] [-mon n] [-v]
DESCRIPTION¶
dunst is a lightweight notification-daemon for the libnotify. dunst displays
messages received via dbus or as commandline argument in a fashion similar to
dmenu.
OPTIONS¶
- -h/--help
- display help message.
- -fn font
- defines the font or font set used.
- -lb/nb/cb color
- defines the background color of low/normal/critical
messages.
- -lf/nf/cf color
- defines the foreground color of low/normal/critical
messages.
- -to secs
- defines the default timeout. Can be (partially) overridden
by the following options.
- -lto/nto/cto secs
- timeouts for low/normal/critical messages.
- -key key
- close window by pressing key. See also -mod.
- -mod modifier
- defines the modifier used in conjunction with -key.
Available modifiers are: ctrl, shift, mod1-mod4. This option can be used
multiple times to combine modifiers.
- -format fmt
- defines the format of the message. See FORMAT.
- -mon n
- show the notification on monitor n.
- -s
- sort messages by urgency.
- -ns
- don't sort messages by urgency.
- -geometry [{width}]x{height}][+/-{x}+/-{y}]
- The geometry of the message window. The height is measured
in lines everything else in pixels. If the width is omitted but the height
is given ("-geometry x2"), the message window expands over the
whole screen (dmenu-like). If width is 0, the window expands to the
longest message displayed. A positive x is measured from the left, a
negative from the right side of the screen. Y is measured from the top and
down respectevly. see also EXAMPLES show the notification on monitor
n.
- -v
- Increase verbosity. Can be used multiple times.
- -config file
- use alternative config file.
fmt is a string containing placeholders. The placeholders will be replaced with
the corresponding text, or if the text is not present, nothing. Possible
placeholders are:
- %a appname
- %s summary
- %b body
- %i iconname (including its path)
- %I iconname (without its path)
COLORS¶
Every option that needs a color as argument accepts #RGB, #RRGGBB and X color
names.
NOTIFY-SEND¶
dunst is able to get different colors for a message via notify-send. In order to
do that you have to add a hint via the -h option.
- notify-send -h string:fgcolor:#ff4444
- notify-send -h string:bgcolor:#4444ff -h
string:fgcolor:#ff4444
CONFIGURATION¶
An example configuration file is included (usually
/usr/share/doc/dunst/dunstrc.example). To change the configuration, copy this
file to ~/.config/dunst/dunstrc and edit it accordingly.
AUTHOR¶
written by Sascha Kruse <knopwob@googlemail.com>
COPYRIGHT¶
copyright 2012 Sascha Kruse and contributors (see LICENSE for licensing
information)
If you feel that copyrights are violated, please send me an email.
SEE ALSO¶
dwm(1),
dmenu(1),
twmn(1),
notify-send(1)
