RunMacro Documentation
Create your first robot, then go further as needed.
Clear step-by-step guides to create, run, and improve robots for repetitive computer work.
RunMacro Flow commands
Pick an item to see a detailed guide.
The Label command places a named marker in the script. It does nothing on its own, but it is the target that G…
The Goto command moves execution to a Label you choose — instead of running straight down. Use it to repeat a …
The Random Goto command randomly picks one Label from a list (up to 10) and jumps there. Each run can take a d…
The Loop command is a special IF block: it repeats the commands below until it reaches a set number of iterati…
The IF command opens a multi-clause logical condition block. Users can chain multiple evaluation rules using A…
The Else and End If pair form the condition block used with IF commands (like Find Image, IF Window, IF Clipbo…
The Group and End Group pair bundle related commands under a name, keeping the script tidy and readable. Group…
The Pause command stops the script at its position and waits until you press the resume hotkey (default F8). U…
The IF File Exists command checks whether a path exists (a file, a folder, or a folder that contains files), t…
The Open File command launches an app, opens a document or a path — like double-clicking it. It can pass comma…
The Goto Parent File command is for scripts that call a sub-macro. It exits the running sub-macro and jumps to…
The Insert .pmacro command calls and runs another macro file as a sub-macro, right at its position. It lets yo…
The Insert RunMacro package command calls and runs a packaged .qmacro workflow as a sub-macro. Like Insert .pm…
The While Loop command repeatedly executes enclosed commands as long as a logical comparison between a variabl…
The For Each Loop command iterates sequentially through elements in a data collection. It supports 5 collectio…
The Break Loop command immediately terminates the innermost enclosing loop block (supporting Loop N times, Whi…
The Continue Loop command bypasses all subsequent instructions in the active cycle of the innermost loop (Whil…
The Delay command makes the macro wait a fixed amount of time (in milliseconds) before running the next comman…
The Call Subflow command invokes and executes a pre-defined Subflow within the same macro project. During exec…
The Return Subflow command is placed inside a Subflow body to immediately terminate subflow execution and eval…
The Smart Desktop IF command evaluates real-time UI element states via Microsoft UI Automation and branches ma…
The Smart Desktop Wait command intelligently pauses execution until a target desktop UI element reaches a desi…
The Stop Macro command immediately flags execution termination (setting stop_requested = True in the execution…
