.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "dunstctl 1"
.TH dunstctl 1 2024-03-15 "1.9.2 (2023-04-20)" "dunstctl reference"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
dunstctl \- Command line control utility for dunst, a customizable and lightweight notification\-daemon
.SH SYNOPSIS
.IX Header "SYNOPSIS"
dunstctl COMMAND [PARAMETER]
.SH COMMANDS
.IX Header "COMMANDS"
.IP "\fBaction\fR notification_position" 4
.IX Item "action notification_position"
Performs the default action or, if not available, opens the context menu of the
notification at the given position (starting count at the top, first
notification being 0).
.IP \fBclose\fR 4
.IX Item "close"
Close the topmost notification currently being displayed.
.IP \fBclose-all\fR 4
.IX Item "close-all"
Close all notifications currently being displayed
.IP \fBcontext\fR 4
.IX Item "context"
Open the context menu, presenting all available actions and urls for the
currently open notifications.
.IP "\fBcount\fR [displayed/history/waiting]" 4
.IX Item "count [displayed/history/waiting]"
Returns the number of displayed, shown and waiting notifications. If no argument
is provided, everything will be printed.
.IP "\fBhistory-pop\fR [ID]" 4
.IX Item "history-pop [ID]"
Redisplay the notification that was most recently closed. This can be called
multiple times to show older notifications, up to the history limit configured
in dunst. You can optionally pass an ID to history-pop, in which case the
notification with the given ID will be shown.
.IP \fBis-paused\fR 4
.IX Item "is-paused"
Check if dunst is currently running or paused. If dunst is paused notifications
will be kept but not shown until it is unpaused.
.IP "\fBset-paused\fR true/false/toggle" 4
.IX Item "set-paused true/false/toggle"
Set the paused status of dunst. If false, dunst is running normally, if true,
dunst is paused. See the is-paused command and the dunst man page for more
information.
.IP \fBdebug\fR 4
.IX Item "debug"
Tries to contact dunst and checks for common faults between dunstctl and dunst.
Useful if something isn't working
.IP \fBhelp\fR 4
.IX Item "help"
Show all available commands with a brief description