Limitless automation, powered by Python.
A high-performance desktop automation framework that bridges the gap between simple recorders and complex software development.
Get Started View on GitHub-
Professional Power --- Script logic in pure Python with access to OpenCV, API requests, and full OS interaction.
-
Sleek GUI --- Manage task lifecycles, variables, and profiles through a user-friendly interface.
-
The Bridge --- The best of both worlds: the ease of a recorder with the limitless potential of a Saturn V rocket.
Quick Start
Option 1: Install via pip (Recommended)
| Bash | |
|---|---|
Option 2: Standalone Executable (Windows)
If you prefer not to use Python environments, you can download the latest pre-compiled .exe from the GitHub Releases page.
Tesseract OCR Required
If you plan to use vision.captureScreenText() in your macros to read text from the screen, you must install the Tesseract C++ binary separately. See the Vision API page for installation details.
See it in Action
Check out the engine showcase, or the short demo reacting to the Human Benchmark in real-time.
View Performance Demo (GIF)
Macro Studio achieving a 17ms average on the Human Benchmark website.
See the Full Showcase
Core Features
Infinite Possibilities
Other macro recorders give you a tricycle; we are handing you the keys to a Saturn V rocket. If you can code it in Python, you can automate it. Import any library, use complex logic, and interact with the OS at a deep level. You are not limited to "click here, wait 5 seconds." If you want your macro to query a database, hit a REST API, and then click the button, go for it.
Visual Task Manager
The central orchestration hub of the studio. It provides a real-time, graphical interface for monitoring and controlling the execution flow of both coded Python tasks and manually recorded macros.
Profile & Variable Management
Define variables (Integers, Booleans, Regions, Points, etc.) that are exposed directly in the GUI. Users can tweak settings safely via the interface without ever touching your code. Values are saved per-profile, allowing you to maintain different configurations for different environments.
The engine currently supports complex types like QRect (Regions), QPoint (Coordinates), and QColor (Colors) with visual screen overlays. This ensures users don't have to manually define these, but they still can if they enjoy the suffering!
Visual Task Recorder (No-Code)
For the days you just don't feel like typing. Record your mouse and keyboard actions with zero coding required. You can even export your recorded sequences directly to a standalone Python script to wrap them in custom logic—it's the perfect way to learn the engine's API, or just save yourself 10 minutes of typing!
Documentation Directory
Ready to start building? Dive into the official documentation to learn how to harness the full power of Macro Studio:
- Engine API - Learn how to initialize the studio, add basic tasks, and run threaded operations.
- Task Controllers - Master the control flow of your macros by safely pausing, resuming, and stopping tasks.
- Actions Library - Explore the built-in, thread-safe mouse and keyboard simulators.
- Vision Library - Give your macros sight with OpenCV and Tesseract OCR integration.
- Registries - Learn how to inject custom types into the engine's UI.
- Examples - View fully runnable, copy-pasteable scripts to jumpstart your development.
Contributing & Support
Contributions are welcome! Whether you are fixing bugs, adding new features, or creating example tasks, I would love to see your work :)
If you find this studio helpful and want to support its development, consider buying me a coffee! It helps keep the updates coming.
A Mission for Open-Source
Macro Studio is, and always will be, 100% free. Curious about the engine's architecture and why I built it? Read the Philosophy here.
