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 Mouse Mouse Wheel
🔄 Mouse

Auto mouse scroll in RunMacro

Mouse Wheel sends the configured number of scroll notches in the selected direction at the cursor or configured coordinates.

Prerequisites#

  • The page or scrollable region is visible.
  • The cursor or coordinates are inside the region that receives scrolling.

Supported modes#

  • Desktop Mode
  • Browser Mode

What it does#

The Mouse Wheel command auto-scrolls the wheel up or down by a number of notches at a position you choose (or the current cursor spot).

Screenshots & video#

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

When to use it#

  • Scroll a page or long list to reveal content to act on.
  • Scroll down to trigger lazy-loading before finding/clicking.
  • Scroll inside a specific area (chat box, table) instead of the whole page.

When not to use it#

  • An exact jump to a specific element is required.
  • The target region does not accept scrolling at the selected position.

Configuration steps#

  1. Add a Mouse › Mouse Wheel command.
  2. Choose the direction: Up or Down.
  3. Enter the number of notches.
  4. (Optional) set the scroll point with F2; leave empty to scroll at the current position.
  5. Save.

Every option explained#

Direction (Up / Down)#

Which way the wheel scrolls.

Notches#

How many wheel steps. More notches scroll farther.

X, Y coordinates (optional)#

Where to place the cursor to scroll; leave empty to use the current spot.

Random notches (±)#

Randomly add/subtract notches each run so scrolling varies instead of being perfectly uniform.

Expected result#

The target region scrolls in the configured direction by the selected notch count.

Real example#

Example: scroll to the bottom to load more#

  1. Add a Mouse Wheel, direction Down, 10 notches.
  2. Set a 500ms delay so the page can load.
  3. Repeat a few times for infinite-scroll pages.

Limitations and failure cases#

  • Actual distance per notch depends on the application and scroll region.
  • Dynamically loaded content may require an additional wait after scrolling.

Tips & common mistakes#

To scroll precisely to an element, pair with Find Image after scrolling to confirm it is visible.
In Browser Mode, the scroll is sent via Chrome/CDP so it does not take over your real mouse.

Verification details#

  • commands/mouse.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.