.\" Generated by scdoc 1.11.2
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "makoctl" "1" "2022-10-15"
.P
.SH NAME
.P
makoctl - controls the \fBmako\fR(1) daemon
.P
.SH SYNOPSIS
.P
makoctl [cmd] [options.\&.\&.\&]
.P
.SH DESCRIPTION
.P
Sends IPC commands to the running mako daemon via dbus.\&
.P
.SH COMMANDS
.P
\fBdismiss\fR [-a|--all] [-g|--group] [-n <id>]
.RS 4
Dismisses a notification.\&
.P
Options:
.P
\fB-a, --all\fR
.RS 4
Dismiss all notifications.\&
.P
.RE
\fB-g, --group\fR
.RS 4
Dismiss the first notification group.\&
.P
.RE
\fB-n\fR <id>
.RS 4
Dismiss the notification with the given id.\& Defaults to the first
notification.\&
.P
.RE
.RE
\fBrestore\fR
.RS 4
Restores the most recently expired notification from the history buffer.\&
.P
.RE
\fBinvoke\fR [-n <id>] [action]
.RS 4
Invokes an action on a notification.\& If \fIaction\fR is not specified, invokes
the default action.\& Action names can be discovered using `makoctl list`.\&
.P
Options:
.P
\fB-n\fR <id>
.RS 4
Invoke the action on the notification with the given id.\& Defaults to
the first notification.\&
.P
.RE
.RE
\fBmenu\fR [-n <id>] <program> [argument.\&.\&.\&]
.RS 4
Use a program to select an action on a notification.\& The list of
actions are joined on newlines and passed to \fIprogram\fR.\& The program should
write the selected action to stdout.\& If an action is given, this action
will be invoked.\&
.P
If no action is found, or no action is selected, \fImakoctl\fR will return
non-zero.\&
.P
Options:
.P
\fB-n\fR <id>
.RS 4
List the actions of the notification with the given id.\& Defaults to
the first notification.\&
.P
.RE
Examples:
.P
.RS 4
.nf
.RS 4
makoctl menu dmenu -p \&'Select Action: \&'
makoctl menu -n 12345 wofi -d -p \&'Choose Action: \&'
.fi
.RE
.P
.RE
.RE
\fBlist\fR
.RS 4
Retrieve a list of current notifications.\&
.P
.RE
\fBreload\fR
.RS 4
Reloads the configuration file.\&
.P
.RE
\fBmode\fR
\fBmode\fR -s <mode>.\&.\&.\&
\fBmode\fR [-a mode].\&.\&.\& [-r mode].\&.\&.\&
.RS 4
When run without any option, retrieves a list of current modes.\&
.P
When run with the \fI-s\fR option, replaces the current modes with the provided
list.\&
.P
When run with the \fI-a\fR or \fI-r\fR options, adds or removes the provided mode
from the current modes.\&
.P
See the \fIMODES\fR section in \fB\fRmako\fB\fR(5) for more information about modes.\&
.P
.RE
\fBhelp, -h, --help\fR
.RS 4
Show help message and quit.\&
.P
.RE
.SH AUTHORS
.P
Maintained by Simon Ser <contact@emersion.\&fr>, who is assisted by other
open-source contributors.\& For more information about mako development, see
https://github.\&com/emersion/mako.\&
.P
.SH SEE ALSO
.P
\fBmako\fR(1)