OS Manuals

/usr/bin/notify-send

GNOME/libnotify mirror

From libnotify 0.8.9-r2 (os), captured 2026-11-05 by running notify-send --help (exit 0). permalink

Usage:
  /usr/bin/notify-send [OPTION…] <SUMMARY> [BODY] - create a notification

Help Options:
  -?, --help                        Show help options

Application Options:
  -u, --urgency=LEVEL               Specifies the urgency level (low, normal, critical).
  -t, --expire-time=TIME            Specifies the timeout in milliseconds at which to expire the notification.
  -a, --app-name=APP_NAME           Specifies the app name for the notification
  -i, --icon=ICON                   Specifies an icon filename or stock icon to display.
  -n, --app-icon=ICON               Specifies an application icon filename or app icon name. The server may or may not display it.
  -c, --category=TYPE[,TYPE...]     Specifies the notification category.
  -e, --transient                   Create a transient notification
  -h, --hint=TYPE:NAME:VALUE        Specifies basic extra data to pass. Valid types are boolean, int, double, string, byte and variant.
  -p, --print-id                    Print the notification ID.
  --id-fd                           File descriptor where to write the notification ID.
  -r, --replace-id=REPLACE_ID       The ID of the notification to replace.
  -w, --wait                        Wait for the notification to be closed before exiting.
  -A, --action=[NAME=]Text...       Specifies the actions to display to the user. Implies --wait to wait for user input. May be set multiple times. The name of the action is output to stdout. If NAME is not specified, the numerical index of the option is used (starting with 0).
  --selected-action-fd              File descriptor where to write the action chosen by the user.
  --activation-token-fd             File descriptor where to write the action activation token. The daemon must support it.
  -v, --version                     Version of the package.
Options (17)
OptionDescriptionSource
-?, --helpShow help optionshelp
-u, --urgency LEVELSpecifies the urgency level (low, normal, critical).help
-t, --expire-time TIMESpecifies the timeout in milliseconds at which to expire the notification.help
-a, --app-name APP_NAMESpecifies the app name for the notificationhelp
-i, --icon ICONSpecifies an icon filename or stock icon to display.help
-n, --app-icon ICONSpecifies an application icon filename or app icon name.help
-c, --category TYPESpecifies the notification category.help
-e, --transientCreate a transient notificationhelp
-h, --hint TYPE:NAME:VALUESpecifies basic extra data to pass.help
-p, --print-idPrint the notification ID.help
--id-fdFile descriptor where to write the notification ID.help
-r, --replace-id REPLACE_IDThe ID of the notification to replace.help
-w, --waitWait for the notification to be closed before exiting.help
-A, --action NAME=]Text...Specifies the actions to display to the user.help
--selected-action-fdFile descriptor where to write the action chosen by the user.help
--activation-token-fdFile descriptor where to write the action activation token.help
-v, --versionVersion of the package.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.