Flawless Automation.
Zero Footprint.
Reliable Windows macro automation with smooth mouse curves, customizable timing variation, and smart image triggers that run quietly in the background.
Natural Bézier Mouse Trajectories
Standard macros snap the cursor instantaneously across straight, rigid paths. Quantum Macro calculates natural cubic Bézier curves with organic acceleration, deceleration, and micro-curve momentum so cursor movement behaves like a human hand.
Runs Quietly in Background
Minimizes straight to your system tray with virtually no CPU impact and under 15MB of RAM while running your loops.
Accurate Recording with Humanized Timing Jitter
Capture keystrokes, mouse clicks, and scroll actions with millisecond accuracy. Enable customizable timing jitter (e.g. 10%–25%) so delay times vary slightly between loops, preventing rigid robotic patterns.
| Feature |
Quantum
|
AutoHotkey (AHK v2) | TinyTask |
|---|---|---|---|
| Mouse Movement Cursor smoothing & paths | Bézier Curve Smoothing | Linear / Scripted Math | Raw 1:1 Snap |
| Delays & Randomization Cooldowns & timing variation | Custom Delays + Timing Jitter | Scripted Sleep & Random() | Fixed Speed Multipliers |
| Visual Triggers Screen monitoring & image matching | OpenCV Image Matching | Basic Pixel Search | None (Blind Replay) |
| Interface Setup, recording & overlays | Visual UI + In-Game HUD | Code & Text Scripts | Simple Toolbar |
| Memory Footprint Active runtime memory | ~240MB – 260MB | ~5MB – 10MB | < 2MB |
Quantum in Action
Watch Quantum automate repetitive tasks, detect on-screen visual cues, and display live overlay status across any app.
Real-Time OpenCV Screen Detection & Automation
Watch Quantum monitor live screen regions for target buttons, calibrate match thresholds, and execute automated input loops with zero delay across any Windows application.
Multi-Trigger Priority Execution
Chained triggers with fallback rules when primary targets aren't found.
HUD Studio & Live Overlay
Customize transparent on-screen widgets, live loop telemetry, and hotkeys across any desktop application.
Interactive Screen Snipping
Snip any button or icon directly off your display with one click to set up instant visual triggers.
Set a search area on screen and snip the icon or prompt you want to look for. Quantum Macro runs your recorded key sequence, checks the screen for your target image, and immediately restarts the loop when it appears.
Select Search Area
Box the exact area on screen to monitor so scanning stays fast and light on your CPU.
Snip Target Image
Snip the button, bite icon, or visual cue that indicates it's time to run the macro again.
Run Sequence
The macro executes your recorded key presses and mouse actions from start to finish.
Scan & Repeat
Once the sequence finishes, image detection checks the screen and restarts the loop automatically.
Vision Tuning & Controls
Real-time parameters & execution telemetry
Getting Started with Quantum
Quantum Macro captures your mouse movements, clicks, and keystrokes with millisecond accuracy and plays them back on command. Whether you are automating repetitive software tasks, filling out endless data forms, or farming resources in games, here is how to create and run your first macro in under 60 seconds.
Recording Your Inputs
Focus on your target window and press F8 on your keyboard to start recording. The status will turn red and show RECORDING.
- Always stay focused on your target window before hitting F8 so you never capture accidental clicks inside the macro app.
- Perform your actions naturally: click buttons, type text, or drag items.
- Take your time—you don't have to rush. Quantum records exact delays between your actions.
- Press F8 again to stop recording. Your sequence will instantly appear in the timeline.
Running & Looping
Once your sequence is recorded, press F7 to start playback. Quantum will take over cursor movement and replay your recorded inputs.
- Single Run vs Loops: Set Max Loops in settings to repeat a set number of times, or leave it at
0for non-stop infinite looping. - Emergency Killswitch: Press F7 to pause, or hit DELETE anytime for an instant panic stop.
- Input Lock: Enable Lock Physical Input so accidental desk nudges don't disrupt your running macro.
Saving Your Sequences
Never lose an important setup. Quantum saves all macro sequences as standalone .rec files directly inside your workspace folder.
- Click Save on the sequence header to give your macro a clean name.
- Use New Folder to group related macros by task, program, or game.
- Quantum protects you from accidental overwrites with built-in confirmation dialogs.
Pro Tip: Global Background Hotkeys
Because F8 and F7 are low-level global Windows hooks, you never need to Alt-Tab to the Quantum window. Keep Quantum open in the background behind your active software (or on a secondary monitor), stay focused on your target window, and trigger recording or playback instantly without interrupting your workflow.
Cursor Movement Profiles
Different applications handle mouse inputs differently. A desktop button requires exact screen coordinates, while a 3D camera requires smooth relative distance panning. Quantum provides three specialized tracking profiles so your cursor behaves properly in any environment.
Absolute Coordinates
Moves your cursor directly to exact screen coordinates (pixel X, pixel Y) regardless of where the mouse currently is.
- Guarantees 100% pinpoint accuracy on static interface elements.
- If a button is at (500, 300), the mouse snaps straight to (500, 300).
- Not suitable for 3D camera controls where the mouse is locked to screen center.
Relative Coordinates
Moves your cursor by distance and direction (+X, -X, +Y, -Y) relative to wherever it sits right now, instead of jumping to fixed screen coordinates.
- Does not care where your window is positioned on your monitor.
- Smoothly tracks curved motion paths and continuous swipes.
- Ideal for virtual viewports where the cursor stays hidden while dragging.
Hybrid Mode
The ultimate dual-mode engine. Standard clicks hit exact spots on screen, but holding Right-Click dynamically switches to smooth relative motion without jumping or shaking.
- The Camera Solution: Completely solves the classic problem where 3D cameras spin wildly out of control under pure Absolute macros.
- Right-click look-around stays silky smooth, while left-clicks still hit exact UI buttons and inventory slots.
- No manual toggling needed—Quantum detects right-click state in real time.
Which profile should you use?
If you are clicking buttons in Windows, browsers, or standard 2D menus, stick with Absolute. If you are playing any 3D game or working inside a 3D modeling app where holding right-click rotates your camera, always pick Hybrid.
Speed, Anti-Detection & Timing
Running a macro too fast can skip application frames, while running with robotic identical delays can trigger automated bot detection. Quantum includes precision speed scaling, humanized timing jitter, and hardware input locks to ensure smooth, safe, and undetectable automation.
Playback Speed Multiplier
Adjust how fast your recorded sequence executes, from 0.2x (slow motion) up to 4.0x (quadruple speed).
- 1.0x (Default): Plays back at the exact natural speed you recorded.
- 1.5x to 2.5x: Great for speeding up tedious data entry, dialog skipping, or routine clicks without dropping inputs.
- Caution at 3.0x+: In fast-paced games or web pages with loading delays, running too fast may attempt to click buttons before they have finished rendering on screen.
Humanization & Jitter (0%–50%)
Automated anti-cheat and bot detection systems look for mechanical consistency—clicks landing at exactly 150.00ms every single time.
- Quantum's Randomize slider injects subtle micro-variations into keystroke delays, hold durations, and cursor paths.
- Recommended Setting: 10% to 20% jitter. This is enough to make every single loop cycle unique while keeping your timing 100% reliable.
- Ensures anti-cheat heuristics and statistical server logs see genuine human hand variance instead of a script.
Loop Delay & Max Loops
Fine-tune how your macro behaves between iterations so systems have time to settle.
- Loop Delay (Seconds): Adds a resting cooldown pause at the end of each sequence before the next loop begins (e.g. 2.5s to let animations finish).
- Max Loops: Set an exact count (e.g. 50 loops) to automatically stop once a task is complete, or keep it at
0for non-stop infinite runs.
Lock Physical Input
Have you ever bumped your mouse or had someone touch your keyboard during a 3-hour automated run and ruin everything?
- Enabling Lock Physical Input in Settings temporarily ignores hardware mouse and keyboard input while playback is active.
- Accidental bumps, desk vibrations, or nudges won't derail the cursor.
- Emergency Safety: Your global stop hotkeys (F7 and DELETE) remain active at all times so you are always in complete control.
Computer Vision & OCR Basics
Traditional macros click blindly based on time. If a loading screen takes 1 second longer than expected, a blind macro clicks the wrong thing and breaks. Computer Vision allows Quantum to "see" your screen and only execute when a specific image, button, or word actually appears.
Define Search Region (ROI)
Never scan your entire 4K monitor—scanning full displays uses unnecessary CPU power and risks false matches from other windows.
- Click Define next to Search Region. Your screen will freeze with an overlay.
- Click and drag a box around just the specific area where the target icon, prompt, or text appears.
- Near-Zero CPU: Constraining the search zone keeps OpenCV scans lightning-fast with virtually 0% CPU footprint.
Image Template Snip
Give Quantum a clear picture of what it should look for on your screen.
- Click Capture and snip the visual target: a dialogue prompt, a ready skill icon, a notification badge, or an in-game bite indicator.
- You can also click Upload to load an existing PNG file with transparency.
- Snip only the core distinguishing feature rather than a huge empty background.
Text Recognition (OCR)
Don't want to rely on images? Switch the trigger mode to Text (OCR) to read live words directly from your screen.
- Type your target word or phrase into the text field.
- Exact Match: Requires the whole word to match without extra characters.
- Case Sensitive: Differentiates between uppercase and lowercase letters.
- Great for dynamic web pages, changing UI skins, and software notifications where button colors vary.
Confidence Threshold Slider
Set how strictly Quantum compares the on-screen pixels to your template image (from 50% to 100%).
- Sweet Spot (75%–85%): The recommended balance. Tolerates minor lighting shifts, anti-aliasing differences, and compression artifacts while preventing accidental triggers.
- 95%–100%: Strict pixel-perfect matching. Use this only if the target is completely static and high contrast.
- Under 65%: Loose matching. Might trigger on similar-looking icons or backgrounds.
Multi-Trigger Studio Guide
Multi-Trigger Studio is Quantum's most powerful feature. Instead of being stuck with one simple image check, you can create a full stack of intelligent condition cards evaluated in priority order. Build complex automated decision trees that react to multiple visual cues, live text, and recurring timers simultaneously.
The Priority Queue Stack
Condition cards evaluate in strict top-to-bottom order (Priority #1, Priority #2, Priority #3...).
- Top Priority First: Quantum continuously monitors Card #1 first. As soon as Card #1's condition is met, its assigned action executes immediately.
- Graceful Fallback: If Card #1 is not detected or is waiting on a cooldown delay, Quantum immediately checks Card #2, and continues down the queue.
- Reordering: Use the Move Up and Move Down buttons on any card to adjust execution priority whenever needed.
- Practical Example: Set Priority #1 to catch unexpected error dialogs or rate-limit warnings and handle them immediately, while keeping standard routine clicks or data transfers at Priority #2 and #3.
Three Versatile Trigger Modes
Every card in your queue can operate under its own independent detection mode:
- Visual Image: High-speed OpenCV template matching inside a designated Search Region (ROI) with an adjustable confidence threshold.
- Text (OCR): Live character recognition that scans for specific phrases, words, or numbers with exact match and case-sensitive filters.
- Timer (Interval): Periodic pulses that fire on a set schedule without scanning the screen. Configure intervals in milliseconds (
ms), seconds (s), or minutes (m)—ideal for refreshing dashboards, auto-saving drafts, polling status feeds, or triggering keep-alive inputs.
Chained Steps (Sub-Cards)
Real-world automation often requires sequential checkpoints: "Wait for Window A to open, then wait for Button B to activate before clicking."
- Click Add Chained Step on any parent card to attach a nested Sub-Step card.
- The parent card detects the primary event (for instance, an "Export Complete" banner appearing).
- The sub-step verifies the secondary condition with its own independent mode, target region, and timeout delay (such as waiting for the "Download CSV" button to turn clickable).
- Zero False Starts: Ensures multi-stage processes only execute when all prerequisites are genuinely verified.
Flexible Action Routing
When a condition triggers, Quantum lets you decide exactly how to respond:
- Active Timeline: Replays the macro sequence currently loaded in your main timeline editor.
- Play File (.rec): Launches an entirely separate, dedicated macro file mapped directly to that event. For example, if a "Sync Complete" prompt appears, Card 1 triggers ArchiveData.rec; if a "Network Timeout" message appears, Card 2 triggers ReconnectSession.rec.
- Pass-Through Gate: Acts as a conditional gatekeeper. It marks the step as verified without pressing any keys, allowing execution to pass smoothly into the next chained action.
Force Play & Safety Limits
Built-in safeguards keep your computer responsive and your automations reliable:
- Force Play: Toggle this on any card to bypass pending interval timers or wait delays and immediately execute its action the instant a match is detected.
- 5-Card Safety Guard: By default, Quantum caps queues at 5 cards to ensure lightweight CPU performance and prevent runaway loops for beginners.
- Unlock Unlimited: Click Limit: 5 Cards in the studio toolbar to remove the cap whenever you need extensive multi-rule setups.
Quantum Presets (.qcv)
Save your entire Multi-Trigger ruleset so you never have to redefine template images, regions, or cooldowns again.
- Click Save Preset to package all your cards, ROIs, thresholds, and chained steps into a portable
.qcvfile. - Click Presets to open your preset library, preview triggers, and switch configurations with a single click.
- Maintain distinct presets for data entry pipelines, desktop workflows, creative suite tasks, or games, and swap between them seamlessly.
HUD Studio & Live Overlay
Alt-Tabbing back and forth to check if your macro is running breaks your workflow. Quantum HUD Studio gives you a customizable, transparent floating overlay widget that sits on top of any application, window, or workspace, giving you real-time feedback at a glance.
What the HUD Displays
Every badge on the floating HUD provides live real-time information:
- State Badge: Shows exact engine status:
IDLE,RECORDING,PLAYING,SCANNING, orTIMER. - Live Millisecond Timer: Precise stopwatch tracking active runtime for the current sequence.
- Loop Counter: Displays how many loops have finished and how many remain.
- Active Action Readout: Shows the exact keystroke or mouse click executing right now.
- Speed Pill & Panic Key: Displays current playback speed multiplier and reminds you of your emergency killswitch.
Positioning & Multi-Monitor
Put the HUD exactly where it doesn't obstruct your workspace or game interface.
- 6 Anchor Zones: Click presets like Top Center, Top Right, Top Left, Bottom Center, Bottom Right, or Bottom Left for instant snap-to-edge alignment.
- Free Dragging: Enable Free Drag to move the HUD anywhere on your desktop with pixel-level precision.
- Multi-Monitor Index: Choose which monitor the overlay appears on with a single dropdown.
Click-Through Mode
The most important setting for desktop and gaming overlays:
- When Click-Through is enabled, your mouse clicks pass straight through the HUD to the application or game window underneath.
- You can shoot, click buttons, or drag files directly "under" the HUD without clicking on the widget by mistake.
- Auto-Hide: Automatically fades the overlay when the macro is idle, and pops it back up the moment a sequence starts.
Themes & Gradient Studio
Customize the visual appearance to fit your desktop theme or gaming aesthetic:
- Curated Palettes: Choose from Cyber Slate, Deep Obsidian, Neon Cyan, Amethyst Void, Emerald Abyss, Sunset Fusion, and Crimson Velvet.
- Live Gradient Studio: Adjust background opacity, corner rounding, border thickness, ambient glow, and linear gradient angles in real time.
- Click Save & Apply Config to update your live overlay instantly without restarting.
Sequence Saves & Client Settings
Keep your macro library organized, locate your files on disk, and configure the desktop client for maximum efficiency.
Storage & File Locations
Quantum stores all user data cleanly inside your Windows Documents folder:
- Root Folder:
Documents\Quantum\ - Macro Sequences:
Documents\Quantum\Saves\holds all your recorded.recsequence files and custom subfolders. - Autosave Backups:
Documents\Quantum\Saves\Autosaves\continuously keeps emergency snapshots of your active sequences so you never lose progress. - Client Settings:
Documents\Quantum\Settings\holds your application preferences, window configurations, and hotkey mappings. - Vision Presets:
Documents\Quantum\Presets\stores your Computer Vision profiles (.qcvfiles) and trigger setups (custom_presets.json).
Managing & Sharing Sequences
Keep your macro library tidy and easily transfer routines between computers:
- Folder Organization: You can create subfolders inside your Saves directory to organize macros by workflow, work project, or software task.
- Safe Overwriting: Quantum provides safe rename and duplicate warning prompts so you never accidentally overwrite an important routine.
- Full Portability: Because recordings are standalone
.recfiles, you can copy, backup, or share them with colleagues or across devices with zero setup.
Low-Power Tray Suspension
Save battery and system resources when you are not actively using the macro:
- Close to Tray: Minimizes Quantum to the Windows notification tray instead of cluttering your taskbar.
- Low-Power Suspension: Fully suspends UI rendering and engine loops while in the tray, dropping RAM consumption below 15MB.
- Keep Window Open to Run: Because tray mode puts Quantum into power-saving sleep, keep the Quantum window open (it can sit behind other windows or on another monitor) whenever you want to record or run sequences.
Keybind Customization
Every hotkey can be remapped to whatever keys or extra mouse buttons you prefer:
- Record Toggle: Default is F8.
- Play / Stop Loop: Default is F7.
- Instant Panic Stop: Default is DELETE.
- Simply click the keybind box in Settings and press your desired key or mouse button to rebind instantly.
Troubleshooting & Best Practices
Ran into a bump? Here are direct, clear answers to the most common beginner issues and how to resolve them immediately.
"Image trigger isn't detecting or misses"
If your Computer Vision trigger isn't firing when your target appears on screen:
- Check Confidence: If set to 95%–100%, slight transparency or lighting changes in the software can cause a miss. Lower the confidence slider to 75%–85%.
- Check the ROI Bounding Box: Did you move the application window? If the window moved, the target might now be outside the Search Region you defined. Re-define the region or make it slightly larger.
- Avoid Busy Backgrounds: Snip only the unique icon or text, without large shifting transparent backgrounds.
"My camera spins wildly in 3D games"
This happens when using Absolute coordinates in a 3D environment (like Roblox, WoW, FFXIV, or CAD software).
- In 3D games, holding right-click locks the mouse to screen center to turn the camera. When a macro tries to move to an absolute coordinate, the game interprets it as infinite spinning.
- The Fix: Switch your Profile from Absolute to Hybrid. Hybrid automatically handles right-click camera rotation with smooth relative deltas.
"Clicks are landing slightly off-target"
If your mouse moves to where a button was supposed to be, but clicks a few pixels to the side:
- This is caused by Windows Display Scaling (e.g. 125% or 150% scaling on high-resolution laptops).
- The Fix: Right-click your desktop > Display settings > check your scale. If you record at 100% scale, make sure you replay at 100% scale.
- Make sure your target application is running in the same monitor and resolution as when you recorded it.
"How do I stop a macro if it goes crazy?"
Never panic if a macro starts clicking somewhere unexpected.
- Press DELETE on your keyboard. This is Quantum's low-level emergency killswitch.
- Pressing DELETE immediately releases all held mouse buttons, releases all keys, terminates the playback loop, and returns total control to your physical hands.
- You can also hit F7 to toggle playback off.
Free Core Macro. Pro Vision Automation.
The core macro engine is completely free with no restrictions. Get a Pro key on Itch.io to unlock OpenCV image detection, with more Pro features coming over time.
Quantum Core
The full macro engine. Record keyboard and mouse sequences, customize your visual HUD, and run automated loops with zero background bloat.
- Full keyboard & mouse macro recording
- Infinite & custom loop playback with delays
- Custom Visual Floating HUD overlay
- Lightweight background tray mode
- 100% offline local JSON storage
- OpenCV live screen image detection
- Targeted screen region scanning (ROI)
- On-screen OCR text recognition triggers
Quantum Pro
Turn macros into smart automation. Detect on-screen images, scan target regions, and trigger conditional loops with OpenCV computer vision.
- Everything included in Quantum Core
- OpenCV live screen image detection & triggers
- Targeted screen region scanning (ROI snip tool)
- On-screen OCR text recognition triggers
- Smart visual loop restarts & conditions
- Vision Studio live matching preview
- Single-device lifetime key (no subscriptions)
Checkout on Itch.io
Complete checkout on Itch.io. Your unique license key (QM-PRO-XXXX-XXXX) is delivered instantly on your receipt and email.
Open App Settings
Launch Quantum Macro, navigate to Settings > OpenCV, and locate the license key field.
Paste Key & Activate
Paste your key and click Activate to unlock all OpenCV image detection features immediately.
Test Image Detection in Your Browser
Want to see how visual triggers work first? Head over to the to test it live.
Windows Installer
QuantumMacro-Setup.exeComplete setup package with desktop shortcuts and automatic runtime verification.
Portable Package
QuantumMacro-Portable.zipZero installation required. Extract anywhere and launch immediately.
BillehTheThird
billehthethird@gmail.com
Activity
Your macro execution activity over the last year.
Personal Information
Manage the details connected to your Quantum account.
Sign-In & Security
Keep your account secure. Authentication methods and linked accounts.
billehthethird@gmail.com
Subscription & Plans
Manage your Quantum license tier, perks, and upgrades.
Choose Your Plan
Quantum Core
- Recording & input playback
- Bézier mouse smoothing
- Human-like timing jitter
- Background tray mode
- OpenCV hardware triggers
- Buyer Discord role
Quantum Pro
- Everything in Core included
- Hardware-accelerated OpenCV triggers
- Multi-region smart ROI scanning
- Buyer Discord role
- All future Quantum updates
Devices
Authorized workstation hardware for your Quantum Pro license.
DESKTOP-BILLEH
Windows 11 (64-bit) • Build 26200Key History
Every license key redeemed on this account.
| License Key | Plan | Status | Claimed Date | Actions |
|---|---|---|---|---|
QM-PRO-••••-••••-984F
|
Quantum Pro |
Active
|
Sep 13, 2026 |
|
Link Another itch.io Purchase
Bought an additional key or gift? Bind it directly to this account.