.\" Generated by scdoc 1.11.3
.\" 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" "2024-05-12"
.PP
.SH NAME
.PP
makoctl - controls the \fBmako\fR(1) daemon
.PP
.SH SYNOPSIS
.PP
makoctl [cmd] [options.\&.\&.\&]
.PP
.SH DESCRIPTION
.PP
Sends IPC commands to the running mako daemon via dbus.\&
.PP
.SH COMMANDS
.PP
\fBdismiss\fR [-a|--all] [-g|--group] [-n <id>]
.RS 4
Dismisses a notification.\&
.PP
Options:
.PP
\fB-a, --all\fR
.RS 4
Dismiss all notifications.\&
.PP
.RE
\fB-g, --group\fR
.RS 4
Dismiss the first notification group.\&
.PP
.RE
\fB-n\fR <id>
.RS 4
Dismiss the notification with the given id.\& Defaults to the first
notification.\&
.PP
.RE
.RE
\fBrestore\fR
.RS 4
Restores the most recently expired notification from the history buffer.\&
.PP
.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`.\&
.PP
Options:
.PP
\fB-n\fR <id>
.RS 4
Invoke the action on the notification with the given id.\& Defaults to
the first notification.\&
.PP
.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.\&
.PP
If no action is found, or no action is selected, \fImakoctl\fR will return
non-zero.\&
.PP
Options:
.PP
\fB-n\fR <id>
.RS 4
List the actions of the notification with the given id.\& Defaults to
the first notification.\&
.PP
.RE
Examples:
.PP
.RS 4
.nf
.RS 4
makoctl menu dmenu -p \&'Select Action: \&'
makoctl menu -n 12345 wofi -d -p \&'Choose Action: \&'
.fi
.RE
.PP
.RE
.RE
\fBlist\fR
.RS 4
Retrieve a list of current notifications.\&
.PP
.RE
\fBhistory\fR
.RS 4
Retrieve a list of dismissed notifications.\&
.PP
.RE
\fBreload\fR
.RS 4
Reloads the configuration file.\&
.PP
.RE
\fBmode\fR 
.br
\fBmode\fR -s <mode>.\&.\&.\& 
.br
\fBmode\fR [-a mode].\&.\&.\& [-r mode].\&.\&.\& [-t mode].\&.\&.\& +
.br
	When run without any option, retrieves a list of current modes.\&
.PP
.RS 4
When run with the \fI-s\fR option, replaces the current modes with the provided
list.\&
.PP
When run with the \fI-a\fR or \fI-r\fR options, adds or removes the provided mode
from the current modes.\&
.PP
When run with the \fI-t\fR option, toggle the mode by removing it when present
and otherwise adding it.\&
.PP
See the \fIMODES\fR section in \fB\fRmako\fB\fR(5) for more information about modes.\&
.PP
.RE
\fBhelp, -h, --help\fR
.RS 4
Show help message and quit.\&
.PP
.RE
.SH AUTHORS
.PP
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.\&
.PP
.SH SEE ALSO
.PP
\fBmako\fR(1)