Hotkeys

Configure global hotkeys to invoke your menus. Keyboard shortcuts, mouse buttons, and function keys are all supported.

Hotkey Types

Keyboard Shortcuts

Set a hotkey using a combination of modifier keys and a key.

Modifier	Symbol
Command	⌘
Option	⌥
Control	⌃
Shift	⇧

You can combine multiple modifiers (e.g., ⌘⇧A, ⌃⌥Space).

WARNING

A key alone without any modifier (e.g., just the A key) can't be used as a hotkey. This prevents conflicts with normal typing.

Mouse Buttons

Use your mouse's middle button or side buttons as hotkeys.

Button	Description
Middle	Middle button (wheel click)
Mouse4	Side button (back)
Mouse5	Side button (forward)
Mouse6 -- Mouse12	Extended buttons (for multi-button mice)

INFO

The left button (button 1) and right button (button 2) can't be used as hotkeys.

Mouse buttons can be combined with modifiers (e.g., ⌘ + Mouse4). You can also use a mouse button on its own without any modifier.

Function Keys

F1 through F12 can be used as hotkeys on their own. Combining them with modifiers is also supported.

TIP

To use function keys without holding fn, enable standard function key behavior in macOS: System Settings > Keyboard > Keyboard Shortcuts > Function Keys.

Close Mode

Each hotkey has a close mode that controls how menu items are executed.

Mode	Behavior	Best for
Release or Click	Execute on key release or click	Radial Menus (default)
Click	Execute on click only	Preventing accidental triggers
Toggle	Execute on click; menu stays open	Repeated actions

Release or Click

The default close mode. It supports two interaction patterns:

• Hold: Hold the hotkey, move the mouse to an item, then release to execute
• Click: Press and release the hotkey, then click an item to execute

This mode works best with Radial Menus and suits most use cases.

Click

Items are only executed on click. Releasing the hotkey doesn't trigger anything.

Use this for List Menus or other situations where the mouse travels a longer distance and you want to avoid accidental triggers.

Toggle

Items are executed on click, but the menu stays open afterward. You can execute multiple actions in a row. Press the same hotkey again to close the menu.

TIP

This is handy for executing several window management actions in sequence or adjusting volume step by step.

Recording a Hotkey

1. Click the "+" button in the menu's hotkey settings
2. Click the input field to enter recording mode
3. Press the key or mouse button you want to use
4. Select a close mode

The recorded hotkey appears in the input field. To change it, click the field and record again.

Conflict Detection

A warning appears when the same hotkey is assigned to multiple menus.

App-specific profiles take priority over the Global Profile, so using the same hotkey across them is fine. You only need to resolve duplicates within the same profile.

See App Profiles for details.