makoctl(1)

📦
version 1.11.0 · 13 versions
, in arch rolling, ubuntu stonking

🎀 makoctl(1) — General Commands Manual, but make it group-chat 🎀

🌸 NAME 🌸

makoctl — controls the mako(1) daemon. 🫶

✨ SYNOPSIS ✨

makoctl [cmd] [options...]

💖 DESCRIPTION 💖

Sends IPC commands to the running mako daemon via dbus. Literally that’s the whole vibe, bestie: you’re sending commands over dbus to the daemon. 🦋

👑 COMMANDS 👑

💅 dismiss

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

Dismisses a notification. Bye-bye, popup. 💨

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. It’s giving “comeback era.” ✨

🦋 invoke

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. Main character energy for your current popups. 💖

Options:

  • -j — Use JSON output.

💜 history

Retrieve a list of dismissed notifications. The receipts are right there. 🧾

Options:

  • -j — Use JSON output.

⭐ reload

Reloads the configuration file. Fresh config, fresh me. 💅

🦋 mode

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) for more information about modes. 👑

🌟 help, -h, --help

Show help message and quit. Slay. ✨

🌈 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)

✨ That’s the whole makoctl(1) page — General Commands Manual energy, dated 2026-03-26. Go off, bestie; your daemon is waiting. periodt 💅💖

📦 where this page comes from