notify-send - Man Page

a program to send desktop notifications

Examples (TL;DR)


notify-send [Options] {summary} [body]


With notify-send you can send desktop notifications to the user via a notification daemon from the command line. These notifications can be used to inform the user about an event or display some form of information without getting in the user’s way.


-?,  --help

Show help and exit.

-u,  --urgency=LEVEL

Specifies the urgency level (low, normal, critical).

-t,  --expire-time=TIME

The duration, in milliseconds, for the notification to appear on screen.

(Ubuntu's Notify OSD and GNOME Shell both ignore this parameter.)

-i,  --icon=ICON[,ICON...]

Specifies an icon filename or stock icon to display.

-c,  --category=TYPE[,TYPE...]

Specifies the notification category.

-h,  --hint=TYPE:NAME:VALUE

Specifies basic extra data to pass. Valid types are INT, DOUBLE, STRING and BYTE.

See Also

The Desktop Notification Spec on


Andre Filipe de Assuncao e Brito <>

Original author

Paul van Tilburg <>

Original author

Riccardo Setti <>

Original author

Referenced By

dunst(1), dunst(5).