makoctl-dismiss

Dismiss the most recent notification

$ makoctl dismiss

$ makoctl dismiss -n [notification_id]

$ makoctl dismiss [[-a|--all]]

$ makoctl dismiss [[-g|--group]]

$ makoctl dismiss [[-h|--no-history]]

makoctl dismiss [ID...]

The makoctl-dismiss command is a subcommand of the makoctl utility, which serves as the control interface for the mako Wayland notification daemon. Its primary function is to remove or hide active notifications displayed by mako from the user's screen. Users can choose to dismiss a specific notification by providing its unique identifier (ID) as an argument. If no ID is supplied, the command will clear all currently active notifications. This makes it a crucial tool for managing the on-screen clutter from applications, allowing users to quickly interact with or remove notifications once they have been seen or are no longer relevant. It operates asynchronously, sending a D-Bus message to the running mako daemon to perform the dismissal.

makoctl-dismiss operates exclusively within a Wayland environment, as mako itself is a Wayland-native notification daemon. It requires the mako daemon to be actively running to function. Notifications are dismissed from the display, but this action does not inherently communicate back to the originating application unless the application specifically listens for D-Bus notification close signals. There is no direct "undo" mechanism for a dismissed notification; once cleared, it cannot be brought back without the originating application sending a new notification.

To dismiss a specific notification, you need its unique ID. These IDs can be obtained by running the command `makoctl list`, which outputs a list of all active notifications along with their respective IDs. You can then use one or more of these IDs with `makoctl dismiss`.

Mako was developed as a lightweight, highly customizable, and Wayland-native notification daemon, gaining popularity in minimalistic Wayland setups like those using Sway or Hyprland. The makoctl utility, including its dismiss subcommand, was introduced as an essential part of the mako project to provide a command-line interface for interaction. This allows users to programmatically control notifications, enabling scripting and integration with other system management tools or keybindings for efficient notification management in a Wayland desktop environment.

mako(1), makoctl(1), notify-send(1), swaymsg(1)