Skip to content

Record and assign macros ​

A macro is a saved sequence of key presses, mouse clicks, pauses and typed text that plays when you press one button. In Gearwise you record a macro or build it step by step on the Macros page, then put it on a button from the device's Assignments tab.

The Macros page with a seven-step macro called Reload and inspect, assigned to the G4 button
The macro list on the left, the selected macro and its steps on the right.

Good to know

Gearwise plays macros itself. A macro only works while Gearwise is running. On Linux, playback uses /dev/uinput, which the udev rule opens for you; see Set up Linux permissions. On Windows it uses the system's own input functions.

Create a macro ​

  1. In the sidebar, under Library, select Macros.

  2. Select New macro. A macro called New macro appears under Your macros.

  3. Select the name at the top of the right-hand panel and type a better one, such as Reload and inspect.

  4. Choose how the macro plays: Play once, Repeat while held or Toggle repeat. See Play modes.

Record the steps ​

  1. Select Record.

    A strip reads Recording. Press keys in this window; each press and release is added with its timing.

  2. Type the keys you want, in the Gearwise window.

    Each key press and each release becomes a step, with a Wait step for the time between them.

  3. Select Stop recording.

Leave Collapse delays under 10 ms ticked to leave out very short pauses. Recording captures keys typed into the Gearwise window only. To add mouse clicks, use Add step.

Build the steps by hand ​

Select Add step and choose a step from the menu:

GroupStepWhat it adds
KeyboardKey tapA press and release of one key. Gearwise asks you to press the key.
Key downHolds a key down until a later Key up.
Key upReleases a held key.
MouseMouse down, Mouse upPresses or releases a mouse button. Pick the button.
OtherDelayA pause. Set its length in milliseconds in the step's Wait box.
Type textTypes a piece of text, entered in Text to type.

Each step has buttons to move it up or down and to delete it. Clear removes all steps.

Play modes ​

ModeWhat happens when you press the button
Play onceThe macro plays one time.
Repeat while heldThe macro plays again and again while you hold the button, and stops when you let go.
Toggle repeatThe first press starts the macro repeating, the second press stops it.

Put the macro on a button ​

  1. Select the device under Devices and open the Assignments tab.

  2. Select the button you want to use.

  3. In the panel, select Macro, then select your macro in the list.

Back on the Macros page, Assigned to lists every button and profile that uses the macro. If it says Not assigned yet, select Go to devices.

In this release, macros work on the buttons of Logitech devices. SteelSeries mice can be remapped but cannot run macros, and Razer and Corsair devices cannot be remapped yet. See Remap buttons.

Delete a macro ​

Select the bin icon next to the macro name (Delete macro) and confirm with Delete. Buttons that used it show Missing macro; give them a new action.

WARNING

Macros send real key presses and clicks to whatever window is in front. Test a new macro in a text editor before you use it in a game or another program. Some online games do not allow macros; check the rules of the game.

Next steps ​