---
name: "makoctl"
section: "1"
platform: "linux"
package: "mako"
version: "1.11.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/makoctl"
---

# makoctl(1)

controls the mako(1) daemon

## NAME

makoctl - controls the [**mako**(1)](/mako/1.md) daemon

## SYNOPSIS

makoctl \[cmd\] \[options...\]

## DESCRIPTION

Sends IPC commands to the running mako daemon via dbus.

## COMMANDS

**dismiss** \[-a\|--all\] \[-g\|--group\] \[-n \<id\>\]

Dismisses a notification.

Options:

- **-a, --all**

  Dismiss all notifications.

- **-g, --group**

  Dismiss the first notification group.

- **-h, --no-history**

  Dismiss the current notification without adding it to history.

- **-n** \<id\>

  Dismiss the notification with the given id. Defaults to the first notification.

**restore**

Restores the most recently expired notification from the history buffer.

**invoke** \[-n \<id\>\] \[action\]

Invokes an action on a notification. If *action* is not specified, invokes the default action. Action names can be discovered using \`makoctl list\`.

Options:

- **-n** \<id\>

  Invoke the action on the notification with the given id. Defaults to the first notification.

**menu** \[-n \<id\>\] \<program\> \[argument...\]

Use a program to select an action on a notification. The list of actions are joined on newlines and passed to *program*. The program should write the selected action to stdout. If an action is given, this action will be invoked.

If no action is found, or no action is selected, *makoctl* will return non-zero.

Options:

- **-n** \<id\>

  List the actions of the notification with the given id. Defaults to the first notification.

Examples:

```
makoctl menu -- wmenu -p 'Select Action: '
makoctl menu -n 12345 -- wofi -d -p 'Choose Action: '
```

**list**

Retrieve a list of current notifications.

Options:

- **-j**

  Use JSON output.

**history**

Retrieve a list of dismissed notifications.

Options:

- **-j**

  Use JSON output.

**reload**

Reloads the configuration file.

**mode** \
 **mode** -s \<mode\>... \
 **mode** \[-a mode\]... \[-r mode\]... \[-t mode\]... +\
 When run without any option, retrieves a list of current modes.

When run with the *-s* option, replaces the current modes with the provided list.

When run with the *-a* or *-r* options, adds or removes the provided mode from the current modes.

When run with the *-t* option, toggle the mode by removing it when present and otherwise adding it.

See the *MODES* section in [mako(5)](/mako/5.md) for more information about modes.

**help, -h, --help**

Show help message and quit.

## AUTHORS

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.

## SEE ALSO

[**mako**(1)](/mako/1.md)