dunstify(1)

💖 dunstify — bestie's guide to yeeting notifications onto your screen 💖

okay so this is the manual for dunstify(1), from the Dunstify Reference, and honestly? it's giving "tiny little command with main character energy." let's get into it 🫶

---

✨ NAME ✨

dunstify — a program to send desktop notifications 💌

---

🌸 SYNOPSIS 🌸

dunstify [OPTION...] SUMMARY [BODY]

---

💅 DESCRIPTION 💅

So dunstify is literally a notify-send alternative, no cap. It's the lil command-line bestie you use to send desktop notifications from the terminal. That's it, that's the vibe. ✨

---

🎀 OPTIONS 🎀

okay this is the part where you screenshot, bestie, because there's a LOT and every single one matters 👑

• -?, --help — shows the help options. your little "what do I do now" button 🙈
• -a, --app-name=NAME — sets the app name of the notification. there's a legacy alias for this one too: --appname (she's old but she still works, respect her 💜)
• -u, --urgency=URG — sets the urgency level of the notification. your options are low, normal, and critical. choose your fighter ⚔️
• -h, --hint=HINT — specifies hints to pass. the valid types are BOOLEAN, INT, DOUBLE, STRING, BYTE and VARIANT (yes all of them, know them, love them). legacy alias: --hints 💫
• -A, --action=ACTION — specifies the actions to display to the user. buttons on your notification, iconic 💅
• -e, --transient — marks the notification as transient. she's just passing through, don't get attached 🦋
• -t, --expire-time=TIMEOUT — the time in milliseconds until the notification expires. yes, milliseconds. legacy alias: --timeout ⏳
• -i, --icon=ICON — specifies an icon to display with the notification. give her a face 🎀
• -I, --raw-icon=PATH — path to the icon to be sent as raw image data. legacy alias: --raw_icon 🖼️
• -c, --category=TYPE — the category of this notification. put her in a box, she belongs somewhere 📦
• -p, --print-id — prints the id, which you can then use to update or replace this notification. legacy alias: --printid. save the id, bestie, you WILL need it later 💾
• -r, --replace-id=ID — set the id of this notification to The ID of the notification to replace. legacy alias: --replace 🔁
• -C, --close=ID — closes the notification with the specified ID. bye bestie 👋
• -w, --wait — blocks until the notification is closed and prints the close reason. legacy alias: -b, --block. she will literally wait for you, that's loyalty 😭
• --stack-tag=TAG — sets the dunst stack tag property of the notification to TAG. a tagged notification will replace an earlier notification with the same tag. so if you tag twice, the second one ghosts the first, periodt.

the following commands are equivalent:

dunstify -h string:x-dunst-stack-tag:TAG "hello"

dunstify --stack-tag TAG "hello"

same energy, two outfits, slay ✨

• --capabilities — prints the server capabilities and exits. she tells you what she can do and then dips 🏃‍♀️
• --serverinfo — prints server information and exits. the full tea on the server, then gone ☕
• -v, --version — prints dunstify version information. heads up tho: this one is 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. be nice about it, they're doing their best 🫶

---

🌈 SEE ALSO 🌈

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

iykyk, go read those next 📚

---

and that's the whole page, bestie!! this was dunstify(1) version 1.13.2, dated 2026-03-19 — go forth and notify, you absolute icon 💖✨🎀