Mouse button down & up (drag) in RunMacro

Prerequisites#

• The target application is ready to receive mouse events.
• The coordinates and button action are configured.

Supported modes#

• Desktop Mode
• Browser Mode — Runs in the background through Chrome CDP: the command dispatches a mouse-down or mouse-up event into the page at viewport coordinates.

What it does#

The Mouse Button command lets you press (Down) or release (Up) a single mouse button — unlike Click which presses and releases at once. Combine steps to build drag & drop.

Screenshots & video#

When to use it#

• Drag & drop: Down at A → Move to B → Up at B.
• Hold the button to select/highlight a region.
• Split press and release for precise control.

When not to use it#

• Only an immediate click is needed; use Mouse Click instead.
• The workflow cannot guarantee matching Down and Up events.

Configuration steps#

1. Add a Mouse › Mouse Button command.
2. Choose the action: Down (press) or Up (release).
3. Choose the button: Left / Right / Middle.
4. Set the X, Y coordinates with F2.
5. Save. For drag & drop, create 3 steps: Button Down → Mouse Move → Button Up.

Every option explained#

Expected result#

The selected mouse button is pressed or released at the configured coordinates.

Real example#

Limitations and failure cases#

• Down and Up should be paired to avoid an unintended held state.
• Coordinates depend on layout and window position.

Tips & common mistakes#

Verification details#

• commands/mouse.py

Related commands#