March 20, 2026
How to Create Custom Mouse Gestures on Mac
macOS gives trackpad users multi-finger swipes, pinch-to-zoom, and smart zoom. Mouse users get almost nothing. If you use a standard USB or Bluetooth mouse with your Mac, here is how to unlock custom gesture control.
The Problem: macOS Ignores Mouse Users
Apple has invested heavily in trackpad gestures. Mission Control, App Expose, desktop switching, and Notification Center all have trackpad shortcuts. But if you plug in a Logitech, Razer, or any third-party mouse, you get left-click, right-click, scroll, and nothing else. Side buttons do nothing by default. There are no hold gestures, no drag gestures, and no way to assign actions to mouse input combinations through System Settings.
This is a significant gap. Many developers, designers, and power users prefer mice for precision work but still want gesture-based shortcuts. The solution is a third-party Mac gesture control app.
What Types of Mouse Gestures Are Possible?
With the right software, you can turn your mouse into a full gesture input device. Here are the gesture types that OmniKey supports on macOS:
- Click gestures: Middle-click, side button click (Button 4/5), and modifier+click combinations. Example: Side button click to open Mission Control.
- Hold gestures: Press and hold a button for a configurable duration to trigger an action. Example: Hold middle-click for 400ms to toggle Keep Awake.
- Drag gestures: Hold a button and drag in a direction (up, down, left, right) to trigger directional actions. Example: Hold side button + drag left to snap the window to the left half of the screen.
- Extra button remapping: Reassign Button 4 and Button 5 (forward/back thumb buttons) to any action. Example: Button 5 to paste from clipboard history.
- Modifier combinations: Combine mouse buttons with keyboard modifiers (Ctrl, Opt, Cmd, Shift) for even more gestures. Example: Cmd+Middle-click to close the window under the cursor.
Step-by-Step: Setting Up Mouse Gestures with OmniKey
Step 1: Install OmniKey
Download OmniKey from omnikeyapp.com. Open the DMG, drag OmniKey to your Applications folder, and launch it. On first launch, macOS will ask you to grant Accessibility permission in System Settings > Privacy & Security > Accessibility. This is required for any app that intercepts global input events.
Step 2: Open Mouse Gesture Preferences
Click the OmniKey icon in your menu bar and select Preferences. Navigate to the Mouse Gestures tab. You will see a list of your current mouse gesture shortcuts (the default configuration includes a few examples to get you started).
Step 3: Create a New Gesture
Click the "+" button to add a new gesture. Choose your trigger from the gesture picker:
- Select the mouse button (middle, side, Button 5)
- Choose the gesture type (click, hold, or drag with direction)
- Optionally add modifier keys (Cmd, Opt, Ctrl, Shift)
Step 4: Assign an Action
OmniKey includes over 50 built-in actions. Pick the one that fits your workflow:
- Window management: Snap left/right/maximize, move to next display, minimize
- App launching: Open any application instantly
- System controls: Mission Control, App Expose, show Desktop, lock screen
- Clipboard: Show clipboard history, paste specific items
- Custom scripts: Run any shell command or AppleScript
- Developer tools: Toggle Metal HUD, open Terminal here, flush DNS
Step 5: Test and Refine
Your gesture is active immediately. Test it anywhere on your Mac. If the gesture feels too sensitive or not responsive enough, you can adjust hold duration thresholds and drag distance in OmniKey's advanced settings. OmniKey uses a 28-pixel drag threshold and 400ms hold threshold by default, which works well for most mice.
Practical Mouse Gesture Setups
Here are some gesture configurations that work well for common workflows:
For Developers
- Side button click: Switch to Terminal / VS Code
- Side button + drag up: Open a new Terminal tab in the current directory
- Middle-click hold: Toggle Keep Awake during long builds
- Button 5 click: Show dev server status
For Designers
- Side button + drag left/right: Snap reference window to left/right half
- Middle-click: Paste from clipboard history (grab hex codes, text snippets)
- Side button + drag up: Maximize Figma or Sketch to full screen
For General Productivity
- Side button click: Open Mission Control
- Side button + drag left/right: Switch between desktops
- Middle-click: Alt+Tab window switcher (with browser tab support)
- Button 5: Launch your most-used app
Why Not Use the Mouse Manufacturer's Software?
Logitech Options+, Razer Synapse, and SteelSeries GG all offer some button remapping. But they have significant limitations: they only work with that brand's hardware, they run heavy background processes, they often require cloud accounts, and their action libraries are basic. OmniKey works with any mouse, runs as a lightweight menu bar app, requires no account, and offers 50+ macOS-native actions including window management, clipboard history, and shell commands.
Trackpad and Magic Mouse Gestures Too
OmniKey is not limited to standard mice. It also supports custom trackpad gestures (multi-finger swipes with configurable finger counts) and Magic Mouse gestures (tap and swipe on the touch surface). You can configure different gestures for each input device and use them all simultaneously. Read more about all of OmniKey's features on the homepage.