Fix Logitech MX Master (Logi Options+) mouse buttons not working as a Flow shortcut

If your Logitech MX Master (or another Logi Options+ mouse) button won't trigger Flow dictation, or a keystroke you mapped in Logi Options+ isn't recording or firing in Flow, this gets your shortcut working in a couple of minutes.

Quick checks

• Is Flow up to date? Update before troubleshooting further.

• Is Logi Options+ running? Active in the background, it can intercept button presses before they reach Flow.

• Are you still in Flow's microphone test or onboarding? Shortcuts are ignored during mic-test mode and before onboarding reaches the dictation step.

• Do you know your push-to-talk shortcut? The Windows default is Ctrl+Win (hands-free is Ctrl+Win+Space); if you've customized it, check Flow's Shortcuts settings before mapping a combination in Logi Options+.

• Does a keyboard shortcut work in Flow? Trigger dictation with Ctrl+Opt or Fn on Mac, or Ctrl+Win on Windows. If it works, the problem is the Logitech button mapping; if it doesn't, the problem is Flow's shortcuts overall, not the mouse.

Why this happens

Logi Options+ converts side-button presses on MX Master mice into swipe gestures instead of mouse button events, and never sends a button release. Push-to-talk needs both a press and a release, so these side buttons can't be bound directly in Flow. Buttons that Logi Options+ does not remap send normal mouse events and bind normally. This behavior is documented for macOS; results on Windows may vary.

How to fix this

1. Open Logi Options+ and select your mouse.

2. Reset both action buttons: click each assigned button (for example a side or thumb button) and set its action to No action (labeled Off or None in some versions), so neither has a Flow shortcut or keystroke assigned.

3. Unbind every mouse-button shortcut in Flow's Shortcuts settings — Flow treats mouse setup as complete while any mouse-bound shortcut remains.

4. Quit Logi Options+ so it is no longer running in the background.

   1. Mac: right-click its menu bar icon and choose Quit.

   2. Windows: right-click its system tray icon and choose Exit, or end it from Task Manager.

5. Update Wispr Flow and let the update finish installing.

6. Quit and reopen Wispr Flow, then press your shortcut. If dictation starts on press and stops on release, you're done.

7. If dictation starts but doesn't stop on release, your Logi Options+ mapping is sending a quick tap rather than a key hold — a fast press-and-release locks Flow into hands-free mode, which needs another press to stop.

Shortcut rules

• Keyboard shortcuts: up to 3 keys, including at least one modifier (Ctrl, Cmd/Win, Alt/Opt, Shift or Fn) or a supported mouse button. Rebind them in Flow's Shortcuts settings.

• Rejected combinations: reserved OS combinations, single letters or numbers on their own, combinations mixing the left and right version of the same modifier, and shortcuts already owned by another action. Re-saving the same shortcut for the action you're editing is allowed.

• Bindable mouse buttons: middle click and Mouse 4–Mouse 10 on Mac; middle click plus Mouse 4 and Mouse 5 on Windows. A mouse button can be combined with a keyboard key (for example Ctrl + Mouse 4).

• Never bindable: left click and right click.

• Aux Button: some Logitech mice report an extra button as a keyboard key, which Flow shows as "Aux Button" — that one can be bound.

• Esc exception: Esc works on its own as the Dismiss shortcut.

FAQs

Still stuck?

Reach out to support if:

• Your Flow shortcut still doesn't fire after completing the steps above.

• A keyboard shortcut (not a mouse button) fails to trigger dictation.

Include your platform (Mac or Windows), mouse model, the shortcut you're trying to use, and what you've already tried. Get in touch at wisprflow.ai/support — most shortcut issues are resolved in one reply.