Gesture-driven productivity for macOS
Turn your trackpad into a powerful command center — swipe, tap, or pinch to control windows, apps, media, and more.
| 🖐️ Multi-touch gestures | Swipe (2–5 fingers), tap (single / double / triple), pinch in & out |
| 🪟 50+ built-in actions | Window snapping, media controls, screenshots, Spaces navigation, custom keyboard shortcuts, and more |
| 🎯 Per-app rules | Assign different actions to the same gesture depending on the active application |
| 🧪 Learning mode | Visualize recognized gestures without executing — perfect for new users |
| 🔄 Undo support | Instantly revert the last window operation |
| 💡 Visual feedback HUD | On-screen overlay confirms every action at a glance |
- macOS (native app, no simulator needed)
- A trackpad — Magic Trackpad or built-in MacBook trackpad
- Download the latest release from Releases.
- Move FlowTouch.app to your
/Applicationsfolder. - Launch the app and grant the required permissions (see below).
FlowTouch needs two system permissions to function:
| Permission | Why |
|---|---|
| Input Monitoring | Captures raw multi-touch data from the trackpad |
| Accessibility | Moves and resizes windows, simulates key events |
Tip: Rebuilding from Xcode may invalidate permissions. If gestures stop working, go to
System Settings → Privacy & Securityand re-add FlowTouch.
| Category | Actions |
|---|---|
| 🪟 Window Layout | Snap left / right / top / bottom, quarter-screen corners |
| 🔲 Window Control | Maximize, minimize, center, restore, close, fullscreen, undo, maximize height / width, minimize all, restore all |
| 🖥️ Screens & Spaces | Move window to next / previous screen, switch Spaces left / right |
| 🏠 Desktop & System | Mission Control, Show Desktop, App Exposé, Launchpad, Spotlight, Lock Screen, Screensaver |
| 📱 App Control | Quit, hide, hide others, switch app, previous app |
| 🗂️ Tab Control | New tab, close tab, next / previous tab |
| 🎵 Media | Play / Pause, next / previous track, volume up / down / mute, brightness up / down |
| 📸 Screenshot | Capture full screen, area, or window |
| ⌨️ Custom Shortcut | Trigger any keyboard shortcut you define |
# Clone the repository
git clone https://github.com/appally/FlowTouch.git
cd FlowTouch
# Open in Xcode
open FlowTouch.xcodeproj
# Then press ⌘R to runCLI build:
# Debug
xcodebuild -project FlowTouch.xcodeproj -scheme FlowTouch -configuration Debug build
# Release
xcodebuild -project FlowTouch.xcodeproj -scheme FlowTouch -configuration Release build| Topic | Guideline |
|---|---|
| Code style | Standard Swift — 4-space indent, // MARK: sections, file names match primary type |
| Naming | UpperCamelCase for types, lowerCamelCase for methods & properties |
| Commits | Conventional Commits (feat:, fix:, …), Chinese messages are welcome |
| Pull requests | Include summary, test steps, and screenshots for UI changes |
See LICENSE for details.