README(1) User Contributed Perl Documentation README(1)
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.
FORMAT
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)
perl v5.14.2 2012-06-27 README(1)