OpenLogi

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.

Actions Ring over a document, aimed at Paste

Aiming toward Paste selects it and shows its label.

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.

Actions Ring editor with the slot editor and Ring size row

The Actions Ring tab, with Ring size at the bottom.

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.

SizeSlot distance from centreSlot sizeCentre area radius
Small62 pt36 pt20 pt
Medium76 pt44 pt24 pt
Large96 pt54 pt28 pt

Actions Ring at Small, Medium and Large

Small, Medium, and Large.

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.

PositionDefault action
TopCut
TopRightCopy
RightPaste
BottomRightBrowserForward
BottomPlayPause
BottomLeftBrowserBack
LeftUndo
TopLeftRedo

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.

On this page