MultiAutoClicker

Professional mouse auto-clicker with advanced macro recording and visual feedback system.

🚀 Features

✨ Visual Feedback System

• 🔴 Recording Indicator - Floating overlay shows recording status
• 📍 Point Markers - Numbered red circles mark each recorded click location
• Real-time Visual Confirmation - See exactly where clicks will occur

⚡ Advanced Hotkey System

• Ctrl+Alt+N - Quick Record (auto-creates timestamped macro)
• Ctrl+Alt+R - Stop Recording (auto-saves macro)
• Ctrl+Alt+P - Toggle Playback
• F8 - Add Point (with visual marker)
• Fully Customizable - All hotkeys configurable through settings

🎛️ Professional Macro Management

• Multi-Step Selection - Select and edit multiple steps simultaneously
• Smart Placeholder Logic - Shows <разные значения> for differing values
• Batch Operations - Apply changes or delete multiple steps at once
• JSON-based Storage - Persistent macro library with metadata

⚙️ Customizable Settings

• Interactive Hotkey Capture - Click field → press keys → automatic detection
• Configurable Default Timing - Set comfortable click speed globally
• Live Updates - Settings apply instantly without restart
• Persistent Configuration - Settings saved across sessions

🎯 System Tray Integration

• Minimize to Tray - Runs in background
• Quick Access Menu - Show/Hide from tray icon
• Professional Icon - Custom designed application icon

📦 Installation

Requirements

• Python 3.8+
• PyQt6
• pynput
• PIL (Pillow)

Setup

# Clone repository
git clone https://github.com/EvgeniyGospk/MultiAutoClicker.git
cd MultiAutoClicker

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # Linux/macOS
# OR on Windows:
# venv\Scripts\activate

# Install dependencies
pip install pynput PyQt6 pillow

# Run application
python main.py

🎮 Usage

Quick Start Workflow

1. Start Recording: Press Ctrl+Alt+N → Recording indicator appears
2. Add Points: Position cursor and press F8 → Red numbered markers appear
3. Stop Recording: Press Ctrl+Alt+R → Auto-saves macro, markers disappear
4. Playback: Press Ctrl+Alt+P to execute saved macro

Advanced Features

• Multi-Step Editing: Select multiple steps (Ctrl+Click, Shift+Click) and edit simultaneously
• Custom Hotkeys: Click Settings → Click hotkey field → Press new combination → Save
• Default Timing: Adjust global click delay in Settings → Timing section
• Macro Library: Save, load, and organize multiple macros

🏗️ Architecture

Core Components

• main.py - PyQt6 GUI application with visual feedback widgets
• engine.py - Macro recording/playback engine with threading
• settings_manager.py - JSON-based configuration system
• macros/ - Directory for saved macro files

Technical Features

• Thread-safe Design - Background keyboard listener with signal/slot communication
• Visual Overlay System - Always-on-top widgets for recording feedback
• Dynamic Hotkey System - Runtime hotkey reconfiguration without restart
• Smart Key Mapping - Qt keyboard events to pynput object conversion

📋 Project Evolution

• v1.0 - Console-based auto-clicker with basic recording
• v2.0 - PyQt6 GUI with visual feedback and professional UX
• v3.0 - Complete settings system with customizable hotkeys and timing
• Current - Multi-step editing and advanced macro management

🔧 Development

Built with modern Python practices:

• PyQt6 for professional GUI
• pynput for cross-platform input handling
• JSON for human-readable configuration
• Threading for responsive UI
• Signal/slot architecture for clean event handling

📄 License

This project is open source. Feel free to use, modify, and distribute.