dunstify(1) Dunstify Reference dunstify(1)

dunstify - a program to send desktop notifications

dunstify [OPTION...] SUMMARY [BODY]

Dunstify is a notify-send alternative that can be used to send desktop notifications from the command line.

-?, --help
Show help options.
Set the app name of the notification. Accepted legacy alias: --appname.
Set the urgency level (low, normal, critical) of the notification.
Specifies hints to pass. Valid types are BOOLEAN, INT, DOUBLE, STRING, BYTE and VARIANT. Accepted legacy alias: --hints.
Specifies the actions to display to the user.
Mark the notification as transient.
The time in milliseconds until the notification expires. Accepted legacy alias: --timeout.
Specifies an icon to display with the notification.
Path to the icon to be sent as raw image data. Accepted legacy alias: --raw_icon.
The category of this notification.
Print id, which can be used to update/replace this notification. Accepted legacy alias: --printid.
Set the id of this notification to The ID of the notification to replace. Accepted legacy alias: --replace.
Close the notification with the specified ID.
Block until notification is closed and print close reason. Accepted legacy alias: -b, --block.
Set the dunst stack tag property of the notification to TAG. A tagged notification will replace an earlier notification with the same tag.

The following commands are equivalent:

dunstify -h string:x-dunst-stack-tag:TAG "hello"
dunstify --stack-tag TAG "hello"
Print the server capabilities and exit.
Print server information and exit.
Print dunstify version information. Not present on Dunst versions prior to v1.13.

Copyright 2011-2014 Sascha Kruse

Copyright 2014-2026 Dunst contributors

Dunst is released under the BSD 3-Clause License, see LICENSE for more information.

If you feel that copyrights are violated, please send an email to the maintainers.

notify-send(1), dunst(5), dunstctl(1), dunst(1)

2026-03-28 1.13.2 (2026-03-18)