StrokeMouse

macOS 鼠标/触控板手势自定义工具。按住该手势的触发键(默认右键,也可中键 / 侧键)绘制轨迹,匹配后执行快捷键、打开应用、窗口操作、媒体键、Shell / AppleScript 等

What is StrokeMouse?

macOS 鼠标/触控板手势自定义工具。按住该手势的触发键(默认右键,也可中键 / 侧键)绘制轨迹,匹配后执行快捷键、打开应用、窗口操作、媒体键、Shell / AppleScript 等 | A macOS mouse gesture customization tool. Hold down the trigger key to execute shortcuts, open applications, shell/AppleScript, etc. after matching.

Overview of StrokeMouse

What it is

StrokeMouse is a macOS mouse and trackpad gesture customization tool. It allows users to draw strokes while holding a trigger key, such as the right mouse button, middle button, or side button, and execute shortcuts, open applications, perform window operations, trigger media keys, run Shell or AppleScript after matching the gesture. Gestures can be global or application-specific. The application runs locally from the menu bar and supports importing/exporting configurations.

Key features

  • Menu bar app with status indicator and optional hidden icon
  • Gesture library with global and per-app scopes, search, filter, sort, batch operations, and JSON import/export
  • Mouse drawing using right, middle, or side buttons, with an optional left-click secondary action
  • Mouse combinations, including scroll and edge actions
  • Mouse button mappings for single clicks, optionally with a modifier
  • Trackpad Draw using one modifier key (default Fn)
  • Experimental Touch Gestures supporting 40 gesture classes, including taps, clicks, swipes, pinches, and rotations
  • Scroll enhancement with independent axis reversal and smoothing
  • Free-path recognition with elastic arc-length alignment
  • Actions including system commands, shortcuts, open app, URL, media keys, window actions, Shell/AppleScript
  • Multi-language UI (English, Simplified Chinese, Traditional Chinese, Korean, Japanese, Russian, French)
  • Light/dark appearance, launch at login, and in-app updates via Sparkle

Use cases

  • Assign custom gestures to common tasks like navigating between spaces or opening applications
  • Automate repetitive actions with stroke-triggered Shell or AppleScript
  • Enhance trackpad functionality with multi-finger gestures
  • Remap mouse buttons for application-specific shortcuts
  • Improve scrolling experience with reverse direction and smoothing

Getting started

bashbrew install --cask licoy/tap/strokemouseAlternatively, download the DMG from the official download page. Ensure macOS 14 Sonoma or later.

License and pricing

AGPL-3.0 open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/licoystrokemouse.svg)](https://yunodb.com/tools/licoystrokemouse?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/licoystrokemouse?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/licoystrokemouse.svg" alt="Featured on YunoDB" height="20"></a>