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)