LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

dunstify

desktop notification sender for dunst

TLDR

Send a notification
$ dunstify "[message]"
copy
Notification with title
$ dunstify "[title]" "[body]"
copy
Set urgency level
$ dunstify -u [critical] "[message]"
copy
Set timeout
$ dunstify -t [5000] "[message]"
copy
Add action button
$ dunstify -A "[action,label]" "[message]"
copy
Replace notification
$ dunstify -r [id] "[updated message]"
copy
Set icon
$ dunstify -i [icon_name] "[message]"
copy
Print the notification ID so it can be replaced later
$ dunstify -p "[message]"
copy
Close a notification by ID
$ dunstify -C [id]
copy

SYNOPSIS

dunstify [options] summary [body]

DESCRIPTION

dunstify is a notification client specifically designed for dunst, offering extended features beyond the standard notify-send utility. It implements the freedesktop.org notification specification with dunst-specific enhancements.The tool's key advantage is notification replacement: by storing the notification ID from a previous call (via --printid), subsequent notifications can update the existing one rather than creating duplicates. This is essential for progress indicators, status updates, and volume/brightness notifications.Additional features include action buttons that can trigger commands when clicked, custom hints for advanced styling, and the ability to close notifications programmatically. The tool integrates seamlessly with dunst's configuration for consistent appearance and behavior.

PARAMETERS

-u, --urgency level

Urgency (low, normal, critical).
-t, --timeout ms
Timeout in milliseconds.
-i, --icon icon
Icon name or path.
-r, --replace id
Replace notification with ID.
-A, --action action,label
Add action button.
-C, --close id
Close notification by ID.
-h, --hints TYPE:NAME:VALUE
Set a hint, e.g. `int:value:50` for a progress bar.
-p, --printid
Print the notification ID (use it later with -r or -C).
-a, --appname name
Name of the sending application.
-I, --raw_icon path
Send the icon as raw image data instead of a name or path.
-b, --block
Block until the notification is closed; exit code reports how it was closed.
-c, --capabilities
Print the notification server capabilities and exit.
-s, --serverinfo
Print notification server information and exit.
-v, --version
Print version and exit.

INSTALL

sudo apt install dunst
copy
sudo dnf install dunst
copy
sudo pacman -S dunst
copy
sudo apk add dunstify
copy
sudo zypper install dunst
copy
nix profile install nixpkgs#dunst
copy

SEE ALSO

RESOURCES

Copied to clipboard
Kai