Actions Ring
Open and configure an eight-slot launcher at the cursor. Aim by direction, hold to choose, pick a size, and use complete per-application layouts and optional haptic feedback.
The Actions Ring is an eight-slot launcher that opens at the cursor. Open it from the device detail screen's Actions Ring tab.
The tab appears on a pointer device with buttons, a device with a haptic panel, or a keyboard with Keys. A keyboard with Keys can bind a key to Show Actions Ring. The MX Master 4's Haptic Sense Panel is also a supported control. On a new device, the panel is bound to Show Actions Ring by default.
Open the ring
Press a control bound to Show Actions Ring to open the ring at the pointer. Press the trigger again to dismiss it.

Aim at a slot
Move the pointer toward a slot to select it. Each slot owns the 45° sector around its direction, so the pointer does not need to reach the slot. A pointer that overshoots still selects it.
Nothing is selected while the pointer stays near the centre. Aiming at an empty slot also selects nothing.
The selected slot grows, and a beam points to it from the centre. Its label appears beside it in a speech bubble. A long label wraps once, then ends in an ellipsis. The other slots float as translucent discs, with no panel behind them.
Choose a slot
The ring offers two ways to choose:
- Click. A short press opens the ring and keeps it open. Aim, then click to run the selected slot.
- Hold and release. Hold the trigger for 250 ms or longer, aim, and release. Releasing over a slot runs it. Releasing with no slot selected closes the ring.
Hold and release works when the trigger press itself opens the ring. A ring that a gesture or a long press opened stays open after the release.
A click near the centre, including on the centre ×, closes the ring. So does a click aimed at an empty slot. On macOS, clicking outside the ring also closes it. The ring closes after 15 seconds.
Configure a ring
Select the device
Select the device, then open Actions Ring from its detail screen.
Choose a layout
Use Profile to select Default or an application.
Edit the slots
Select a slot, then choose its action, icon, and optional label.
Bind the trigger
Assign Show Actions Ring to a supported mouse control or keyboard key.
Below the editor, Show ring on button press turns the ring on or off for this device. Ring size sets its size. Haptic feedback appears on a device with haptics.

Ring size
Ring size offers Small, Medium, and Large. Medium is the default. The size belongs to the device and applies to every layout of that device.
Small is a tighter ring for a hand that barely moves the mouse. Large is a wider ring with larger slots. The centre area, where nothing is selected, grows with the ring.
| Size | Slot distance from centre | Slot size | Centre area radius |
|---|---|---|---|
| Small | 62 pt | 36 pt | 20 pt |
| Medium | 76 pt | 44 pt | 24 pt |
| Large | 96 pt | 54 pt | 28 pt |

Slots
Each populated slot stores one action, an optional custom icon, and an optional literal label. Select Clear slot to remove the whole entry. An omitted entry is an empty slot.
The editor rejects Show Actions Ring and None inside a slot. The first
would recursively open a ring. The second does not represent an empty slot.
| Position | Default action |
|---|---|
Top | Cut |
TopRight | Copy |
Right | Paste |
BottomRight | BrowserForward |
Bottom | PlayPause |
BottomLeft | BrowserBack |
Left | Undo |
TopLeft | Redo |
Use Icon to keep the action-derived icon with Use action icon or select a custom icon. A custom label renders exactly as written when you hover its slot.
The additional general-purpose icons are:
- Folder, File, Globe, and Terminal
- Star, Heart, Calendar, and Bell
- User, Palette, and Book
The Haptic feedback switch appears only when the device reports haptic support. When enabled, OpenLogi requests feedback when you hover or activate a populated slot.
The editor also offers these Power User actions:
- Type Text
- Run AppleScript on macOS
- Run Shell Command
Workflow is not available in the Actions Ring editor. It remains available in the keyboard editor.
Per-app layouts
Use Profile to edit the Default layout or an application layout. An application without a saved layout displays the default layout. Its first slot edit copies that layout into an application-specific layout.
The foreground application selects the layout at runtime. The application chosen in the editor does not change the foreground application. Removing an Actions Ring application layout does not remove that application's button overrides.
An application layout replaces the default layout. List every slot that the application needs; omitted slots are empty.
In the config
Actions Ring settings live under [devices.<key>.action_ring] in
config.toml. action_ring.per_app accepts the same app
selectors as button profiles, including Windows exe:<name>.exe and
app:<alias> keys. See Per-app profiles for selector
behavior and Configuration for the complete reference.
schema_version = 11
[devices."unit:6be9d300".action_ring]
enabled = true
haptics = true
size = "medium" # "small", "medium", or "large"
[devices."unit:6be9d300".action_ring.default.slots]
Top = { action = "Copy" }
Right = { action = "Paste", icon = "Keyboard", label = "Paste plain text" }
# This layout replaces the default. Unlisted slots remain empty.
[devices."unit:6be9d300".action_ring.per_app."com.google.Chrome".slots]
Top = { action = "Paste" }Platform behavior
OpenLogi opens the ring on the display containing the cursor. On Wayland, it creates one display-covering window per display and draws the panel at the pointer. Windows calculates ring placement correctly on mixed-DPI displays.
Status: macOS, Linux, and Windows. Haptic feedback requires a device with
0x19b0 hapticFeedback. Outside-click
dismissal is available on macOS only.