Skip to content

zhicheng233/WhereMyWinCursor

Repository files navigation

WhereMyWinCursor

WhereMyWinCursor Logo

A utility to help you find your Windows cursor like MacOS

.NET 9.0 Windows Version License

Demo

简体中文

✨ Features

  • 🖱️ Quick Cursor Locator - Shake your mouse rapidly to trigger a cursor enlargement animation
  • 🎯 Smart Detection - Automatically detects cursor type and applies appropriate animation
  • ⚙️ Highly Configurable - Customize cursor size, animation speed, and more
  • 🌍 Multi-language Support - English, Simplified Chinese and more!
  • 🎭 Theme Support - Light, Dark, and System theme options
  • 📌 System Tray - Runs quietly in the system tray
  • 🚀 Start with Windows - Optional auto-start with system boot

🎯TODO

  • 🚫 Whitelist - You can decide on which program to disable
  • 🎮 GameMode - Disable functionality when app is full screen
  • 💫 non-linear animation - Makes animations smoother

🔧 Requirements

📥 Installation

Option 1: Download Release

Download the latest release from the Releases page.

Option 2: Build from Source

# Clone the repository
git clone https://github.com/zhicheng233/WhereMyWinCursor.git

# Navigate to the project directory
cd WhereMyWinCursor

# Build the project
dotnet build -c Release

# Run the application
dotnet run

🚀 Usage

  1. Launch the application - The app will start minimized in the system tray
  2. Shake your mouse - Quickly move your mouse left and right to trigger the cursor animation
  3. Find your cursor - The cursor will enlarge and then return to normal size

⚙️ Configuration

Right-click the system tray icon and select "Open Settings" to configure:

🛠️ Tech Stack

📁 Project Structure

WhereMyWinCursor/
├── App.xaml(.cs)              # Application entry point
├── Core/
│   ├── Cursor.cs              # Cursor manipulation via Windows API
│   ├── CursorHook.cs          # Mouse movement hook
│   ├── Config/                # Configuration management
│   │   ├── ConfigManager.cs
│   │   ├── MainConfig.cs
│   │   └── ...
│   └── Utils/                 # Utility classes
│       ├── AppInfo.cs
│       ├── FastCursorDetector.cs
│       └── ...
├── UI/
│   ├── SettingWindows.xaml(.cs)
│   └── Pages/                 # Settings pages
├── Resources/
│   ├── icon.ico
│   ├── Lang.en_US.xaml
│   └── Lang.zh-CN.xaml
└── config.json                # User configuration

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the project
  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

Alt

📄 License

This project is licensed under the GNU General Public License v3.0 License - see the LICENSE file for details.

🙏 Acknowledgments

  • Inspired by the macOS "shake to find cursor" feature
  • Thanks to all the open-source libraries used in this project

📬 Contact

If you have any questions or suggestions, please open an issue on GitHub.


Made with ❤️ for Windows users who lose their cursor

About

⚡A utility to help you find your Windows cursor like MacOS

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages