Skip to content

cch01/mouse-automator

Repository files navigation

🐭 Mouse Automator

Mouse Automator is a lightweight, user-friendly desktop application designed to automate mouse clicks with ease. Whether you're gaming, testing software, or handling repetitive tasks, Mouse Automator has you covered!

Mouse Automator

Platform

Supports: Mac🍎, Windows🪟, Linux🐧*

*Linux version only tested on KDE desktop environment. Not all desktop environment support is expected. Voluntary testing & issues openings are welcomed 😁


🛠️ How It's Made

This application is built with:


✨ Features

#### 1. 🎯 Application Selection

  • Quickly search and select the target applications for automated clicks as long as they are running.

2. 🔧 Mouse Action Configuration

  • Interval Settings: Set the time interval between each click (in seconds).
  • Mouse Action: Choose from a range of click types:
    • 🖱️ Single Click or 🔁 Double Click
    • 🔵 Left Click, 🟡 Middle Click, or 🔴 Right Click
  • Preserve Settings: Save and automatically reload your configurations.

3. ⚙️ General Settings

  • 🚀 Start on Login (Windows Only): Run the application automatically when your system starts.
  • 🗂️ Close to Tray: Minimize the application to the system tray for easy access.

4. 🕹️ Control Panel

  • ▶️ Start / ⏹️ Stop: Begin or end the automated clicking process with a single click.
  • ❌ Exit: Close the application, with an option to minimize it to the tray.

5. 💻 System Integrations

  • 📤 System tray: Runs in system tray and control with a single click in context menu.
  • 🎐 Native system notifications: Get OS native notifications when controlled through system tray

🚀 Getting Started

  1. Select Your Target Application: Use the search bar to find the application you want to target.
  2. Configure Your Mouse Actions: Set the click interval, type, and other preferences.
  3. Tweak General Settings: Customize options like startup behavior and tray minimization.
  4. Start Clicking!: Hit the "Start" button to begin automation and "Stop" to end it.
  5. Exit: Choose to fully close the application

📥 Installation

  1. Select and download the latest version of Mouse Automator of desired platform from the releases page.
  2. Run the installer and follow the prompts. (For Windows)
  3. Launch the app and start automating your mouse clicks!

💡 Tips & Tricks

  • Use the Preserve Settings option to quickly reuse your preferred configurations.
  • The Close to Tray feature is great for keeping the app running without cluttering your taskbar.

🛣️Feature Roadmap

  1. 🎯 Search Windows by Title & click at targeted window
  2. 💀 Auto Kill Application
  3. ⌨️ Hotkey Activation
  4. 🛑 Stop After timer | count of clicks | until stopped
  5. 🌠 Click at desired screen coordinates
  6. 🗃️ Multiple Profiles save/load
  7. 🌟 Click Feedback
  8. 🤖 Advanced Macro Editor (Action Timeline, Action Editor)

📄 License

This project is licensed under the MIT License. See the LICENSE.md file for more details.


👨‍💻 Contributing

Feel free to contribute, share your thoughts, or report issues. Happy automating! 😄