Docs

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.

Docs Code Screenshot
📸 Code

Auto-capture a screenshot in RunMacro

The Screenshot command captures the full screen or a region and saves a PNG to a folder with a sequential or random name.

Prerequisites#

  • Add Screenshot to the macro.
  • Prepare the data or target that Screenshot will use.

Supported modes#

  • Desktop Mode
  • Browser Mode — Runs in the background through Chrome CDP: the command captures the page inside Chrome instead of the whole screen.
  • RunMacro Runner

What it does#

The Screenshot command captures the full screen or a region and saves a PNG to a folder with a sequential or random name. In Browser Mode, it captures from the Chrome page.

Screenshots & video#

RunMacro Screenshot command configuration dialog showing parameter fields
Configuration dialog and parameter fields for the Screenshot command in RunMacro.

When to use it#

  • Save step-by-step evidence during a run.
  • Capture results/state to review later.
  • Grab a specific region for image processing.

When not to use it#

  • Do not use it when the screen contains sensitive data or only a specific browser element should be captured.

Configuration steps#

  1. Add a Code › Screenshot command.
  2. Choose the save folder and capture mode (full / region).
  3. For region: enter X, Y and width, height.
  4. Choose the naming mode (sequential / random). Save.

Every option explained#

Save folder#

Where to save the PNG. Must already exist.

Capture mode (full / region)#

Capture the whole screen, or a region by coordinates and size.

X, Y + Width, Height (region)#

Define the region to capture in region mode.

Naming (sequential / random)#

Name files sequentially (1.png, 2.png...) or with a random number.

Expected result#

After execution, Screenshot completes the described action and makes its result available to the next step.

Real example#

Example: capture the full screen each step#

  1. Screenshot, folder C:\Shots, full screen, sequential naming.
  2. Place after key steps to save evidence.

Limitations and failure cases#

  • Output depends on current screen, DPI, multiple monitors, and capture permission; covered windows appear as displayed.

Tips & common mistakes#

In normal mode, the RunMacro window is briefly hidden so it does not appear in the shot.

Verification details#

  • commands/code.py
RunMacro robot

Robots do the work. Your time is yours.

Create a robot in minutes, no coding needed. Reliable execution, remote management, transparent costs — and you always stay in control.