dunstctl

dunstctl command [args]

dunstctl is the command-line control interface for the dunst notification daemon. It provides runtime management capabilities without requiring configuration file changes or daemon restarts.The tool allows closing notifications programmatically, managing notification history, toggling pause state (do-not-disturb mode), and reloading dunst's configuration. It's commonly used in window manager keybindings and scripts for notification management.Key features include history navigation (pop the most recent notification from history), pause state management for temporarily suppressing notifications, and live configuration reloading. The close commands can target specific notifications or clear all visible ones at once. Pause levels (0-100) can be combined with per-notification overridepauselevel for selective display during do-not-disturb mode.

close

Close current notification.

Close all notifications.

Show notification from history.

Set pause state (true, false, toggle).

Check pause state.

Show notification count (all categories if no argument given).

Export notification history as JSON.

Delete all notifications from history.

Reload configuration.

Enable, disable, or toggle a named rule.

Perform default action on notification at position N (0 = top).

Get current pause level (0 = not paused, 100 = fully paused).

Set pause level (0-100), combines with notification overridepauselevel.

Print debug information.

Open context menu with actions/URLs for open notifications.

dunst(1), dunstify(1), notify-send(1)