Docs
Download

Shortcuts

Run operators or open menus with keyboard shortcuts.

A Shortcut node (Add › Operators) adds a keyboard shortcut that runs an operator or opens a menu. It goes into Blender's keymap like Blender's own shortcuts, so users can change it or turn it off in Preferences › Keymap.

Ctrl Shift G runs the Greet operator in the 3D Viewport, Alt Q opens the Quick Tools menu everywhere

Setting one up

Choose what it does in the first dropdown: Run Operator or Open Menu.

Pick the operator or menu. For Run Operator, the button next to the field switches between your operators and Blender's, like on Run Operator. Open Menu opens one of your Menu, Pie Menu or Panel nodes at the mouse (see Menus).

Click the key button (it shows the current shortcut, e.g. "Ctrl Shift G") and press the keys you want, modifiers included. Esc cancels. The dropdown next to it lists every key, mouse button and wheel direction if you'd rather pick one.

Set Where it works, and when it runs.

Settings

Setting
Key buttonRecords the shortcut: click it, then press the keys (the status bar says "Press the shortcut, Esc to cancel"). Modifier keys alone, mouse moves and timers are ignored
Key dropdownThe key, picked from a list (default A)
Ctrl, Shift, Alt, CmdModifier keys that must be held. Cmd is the Windows key on Windows and Linux
WhereThe keymap it goes into: Window works everywhere, an editor (3D View, Node Editor, Image, Text, ...) only over that editor, a mode (Object Mode, Mesh for mesh Edit Mode, Sculpt, Pose, ...) only in that mode. Type to search. A name that isn't a keymap turns red and gives an error
EventWhen it runs: Press, Release, Click (pressed and released without moving), Double Click, Click Drag

With Run Operator, the operator's properties are inputs of the node, the same as on Run Operator. The shortcut runs the operator with these values.

Things to know

  • Input values are fixed when the add-on is enabled: the keymap stores them. A connected node is evaluated once at that moment, not each time the key is pressed. Nodes that only have a value while an operator runs (like Event Info) give nothing there; the node then warns that the operator's default is used.
  • Shortcuts run operators as if they were clicked: dialogs and file browsers open, modal operators start.
  • A shortcut can hide one of Blender's with the same keys in the same place. Check Preferences › Keymap (search by key) for conflicts, and prefer keys with modifiers.
  • Shortcuts appear in Preferences › Keymap under the keymap you picked.