⚡ ZMacro

A high-performance, GUI-based macro recorder and automation suite built with Python.

---

📌 Overview

ZMacro is a powerful automation tool designed for precision control of mouse and keyboard inputs. It supports both real-time recording and manual macro creation, making it ideal for advanced workflows, productivity tasks, and testing scenarios.

With a responsive UI and a multi-threaded engine, ZMacro delivers frame-perfect playback without sacrificing performance.

---

✨ Features

🔁 Dual-Mode Automation

🎥 Macro Recording

• Records real-time:
  • Mouse movement
  • Mouse clicks
  • Keyboard input
• Sub-millisecond accuracy for precise playback

🛠️ Manual Builder

• Create macros from scratch
• Define:
  • Screen coordinates
  • Key inputs
  • Custom timestamps
• No physical input required

---

🎮 Global Hotkeys

• F9 → Start / Stop Recording
• F10 → Play / Pause Macro

---

💾 Config Management

• Export macros as .json files
• Import saved configurations
• Easy sharing and backup

---

🎯 Precision Playback

• Speed Multiplier
  • Adjustable from 0.5x to 5.0x
• Loop Control
  • Set loop count
  • 0 = infinite loop

---

⚡ Asynchronous Engine

• Multi-threaded architecture
• Smooth UI with no freezing
• Accurate timing during playback

---

🎨 Modern UI

• Built with CustomTkinter
• Clean, dark-themed interface
• Native Windows 11-style design

---

🚀 Getting Started

📋 Prerequisites

• Python 3.9+
• Windows / Linux / macOS

  ⚠️ Note: Global hotkeys and mouse control may require OS-level permissions

---

📦 Installation

Go to Releases