---
name: "dunstify"
section: "1"
platform: "linux"
package: "dunst"
version: "1.13.2-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/dunstify"
---

# dunstify(1)

a program to send desktop notifications

## NAME

dunstify - a program to send desktop notifications

## SYNOPSIS

dunstify \[OPTION...\] SUMMARY \[BODY\]

## DESCRIPTION

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

## OPTIONS

- **-?, --help**

  Show help options.

- **-a, --app-name=NAME**

  Set the app name of the notification. Accepted legacy alias: **--appname**.

- **-u, --urgency=URG**

  Set the urgency level (low, normal, critical) of the notification.

- **-h, --hint=HINT**

  Specifies hints to pass. Valid types are BOOLEAN, INT, DOUBLE, STRING, BYTE and VARIANT. Accepted legacy alias: **--hints**.

- **-A, --action=ACTION**

  Specifies the actions to display to the user.

- **-e, --transient**

  Mark the notification as transient.

- **-t, --expire-time=TIMEOUT**

  The time in milliseconds until the notification expires. Accepted legacy alias: **--timeout**.

- **-i, --icon=ICON**

  Specifies an icon to display with the notification.

- **-I, --raw-icon=PATH**

  Path to the icon to be sent as raw image data. Accepted legacy alias: **--raw\_icon**.

- **-c, --category=TYPE**

  The category of this notification.

- **-p, --print-id**

  Print id, which can be used to update/replace this notification. Accepted legacy alias: **--printid**.

- **-r, --replace-id=ID**

  Set the id of this notification to The ID of the notification to replace. Accepted legacy alias: **--replace**.

- **-C, --close=ID**

  Close the notification with the specified ID.

- **-w, --wait**

  Block until notification is closed and print close reason. Accepted legacy alias: **-b, --block**.

- **--stack-tag=TAG**

  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"
  ```

- **--capabilities**

  Print the server capabilities and exit.

- **--serverinfo**

  Print server information and exit.

- **-v, --version**

  Print dunstify version information. Not present on Dunst versions prior to v1.13.

## COPYRIGHT

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.

## SEE ALSO

[**notify-send**(1)](/notify-send/1.md), [**dunst**(5)](/dunst/5.md), [**dunstctl**(1)](/dunstctl/1.md), [**dunst**(1)](/dunst/1.md)