💜 GestureFlow

Control your PC with a flick of your wrist

Download · Documentation · Report Bug

---

🎯 Overview

GestureFlow is a high-performance gesture recognition system for Windows that lets you control your PC with intuitive mouse movements. Draw gestures in the air and watch your commands execute instantly.

Why GestureFlow?

• ⚡ Ultra-fast: Less than 100ms latency from gesture to action
• 🎨 Beautiful: Premium dark UI with glassmorphism effects
• 🖌️ Customizable: Create your own trail skins with JSON
• 🌐 Multi-language: Full English/Russian support
• 🔥 Hot-reload: Changes apply instantly without restart

---

✨ Features

🎯 Smart Recognition Accurate gesture detection Minimal false positives Configurable thresholds Real-time visual feedback	🎨 Premium UI Modern dark theme Glassmorphism effects Smooth animations Professional design
🖌️ Custom Skins 6 built-in styles JSON-based configuration Hot-reload support Unlimited custom skins	⚙️ Configurable Fine-tune every parameter JSON configuration file Custom gesture bindings Per-app profiles (coming soon)

---

🚀 Quick Start

Installation

1. Download the latest release from Releases
2. Extract GestureFlow-v0.9.5.zip to any folder
3. Run GestureFlow.exe
4. Right-click the system tray icon to access settings

Note

No installation required. GestureFlow is a portable application.

Requirements

• Windows 10 / 11 (64-bit)
• .NET 10 Runtime (included in release)
• No admin privileges needed

---

🎮 Usage

Supported Gestures

Gesture	Action	Default Hotkey
← Swipe Left	Browser Back	Alt + Left
→ Swipe Right	Browser Forward	Alt + Right
↑ Swipe Up	New Tab	Ctrl + T
↓ Swipe Down	Close Tab	Ctrl + W
○ Circle	Refresh Page	F5
✓ Checkmark	Minimize Window	Win + D

How to Use

1. Hold the right mouse button
2. Draw a gesture (the trail will appear)
3. Release to trigger the action

Tip

You can customize all gestures and hotkeys in settings.json.

---

🛠️ Tech Stack

---

📁 Project Structure

GestureFlow/
├── Core/
│   ├── GestureRecognizer.cs    # Gesture detection logic
│   ├── ActionExecutor.cs       # Action mapping
│   └── MouseHook.cs            # Low-level mouse hooks
├── UI/
│   ├── MainWindow.xaml         # WPF WebView2 host
│   ├── MainWindow.xaml.cs      # C# <-> JS bridge
│   └── web/                    # HTML/CSS/JS interface
│       ├── index.html
│       ├── styles.css
│       └── app.js
├── Services/
│   ├── ConfigService.cs        # JSON configuration
│   ├── SkinManager.cs          # Trail skin management
│   └── TrayIconManager.cs      # System tray integration
├── Models/                     # Data models
└── settings.json               # User configuration

---

⚙️ Configuration

All settings are stored in settings.json. Example:

{
  "trail": {
    "skin": "Neon",
    "thickness": 4.0,
    "glow": true
  },
  "thresholds": {
    "minGestureLengthPx": 50,
    "moveThresholdPx": 10,
    "holdThresholdMs": 150
  },
  "bindings": {
    "left": "Alt+Left",
    "right": "Alt+Right",
    "up": "Ctrl+T",
    "down": "Ctrl+W",
    "circle": "F5",
    "checkmark": "Win+D"
  }
}

Creating Custom Skins

Create a JSON file in the skins/ folder:

{
  "name": "My Custom Skin",
  "type": "gradient",
  "colors": ["#FF50B4", "#A855F7", "#6366F1"],
  "thickness": 4.0,
  "glow": true
}

---

🗺️ Roadmap

• Core gesture recognition
• 6 built-in trail skins
• Custom skins via JSON
• Hot-reload support
• Premium UI redesign
• Multi-language support (EN/RU)
• Gesture recording & playback
• Statistics & analytics dashboard
• Plugin system for custom actions
• Cloud sync for settings
• Per-application gesture profiles
• Voice command integration

---

🤝 Contributing

Contributions are welcome! Here's how you can help:

🐛 Report Bugs

Found a bug? Open an issue

💡 Suggest Features

Have an idea? Request a feature

🔧 Submit Pull Requests

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

🌟 Star the Repo

If you find this project useful, consider giving it a star!

---

📖 Documentation

Building from Source

git clone https://github.com/BestArmor/GestureFlow.git
cd GestureFlow
dotnet restore
dotnet build
dotnet run

Publishing a Release

dotnet publish -c Release -o ./publish
Compress-Archive -Path ./publish/* -DestinationPath GestureFlow-v0.9.5.zip

---

📜 License

This project is licensed under the MIT License — see the LICENSE file for details.

---

🙏 Acknowledgments

• Inspired by modern gesture control systems
• UI design inspired by Linear and Vercel
• Built with .NET 10 and WPF
• WebView2 integration for modern HTML/CSS/JS interface

---

📞 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions

---

Made with 💜 by BestArmor

If GestureFlow helps you, consider giving it a ⭐!