Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
lightweight and customizable notification daemon
C Shell Makefile

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
.gitignore
AUTHORS
LICENSE
Makefile
README.pod
config.mk
draw.c
draw.h
dunst.c
dunst.h
dunst_dbus.c
dunst_dbus.h
dunstrc
ini.c
ini.h

README.pod

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/dunst/dunstrc). 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)

Something went wrong with that request. Please try again.