Keymap

On this screen, you can configure keyboard and mouse shortcuts.

../../_images/editors_preferences_section_keymap.png

Blender Preferences Keymap section.

Se også

Common Shortcuts

Presets

At the top of the window, you can select and manage presets.

Keymap Presets

The selector lets you choose from builtin presets:

  • Blender: the default keymap, which is the one used throughout this manual.

  • Blender 27x: legacy keymap as used in Blender 2.79 and before.

  • Industry Compatible: a keymap which more closely matches other 3D editing applications.

You add a custom keymap configuration using the Add button +.

You remove a custom keymap configuration using the Remove button -.

Import

Opens a File Browser to select a .py file containing a custom preset.

Export

Saves the current keymap configuration as a preset others may use.

All Keymaps

When disabled, only the shortcut assignments that have been modified will be exported. This exported file may be thought of as a «keymap delta» instead of a full export.

When enabled, the entire keymap is written.

Filtering

Below the preset list, you can filter the list of operations so you can quickly find the one you need.

Filter Type
Name:

Filter the operations by their name (such as New File).

Key Binding:

Filter the operations by their currently assigned shortcut (such as ctrl n).

Search

The text to search (leave blank to show all operations).

Preferences

These preferences only apply to the Blender keymap.

Select with Mouse Button

Controls which mouse button is used to select items.

Left:

LMB selects items while RMB opens the context menu.

Right:

RMB selects items while LMB places the 3D Cursor.

Spacebar Action

Controls the action of Spacebar.

Play:

Starts/stops playing through the Timeline. This option is good for animation or video editing work.

Tools:

Opens the Toolbar underneath the cursor to quickly change the active tool. This option is good if you are doing a lot of modeling or rigging work.

You can select tools in multiple ways:

  • Press Spacebar, then click a tool with the mouse.

  • Hold Spacebar, move the mouse to a tool, and release Spacebar.

  • Press Spacebar, then press the key that’s shown in the popover (e.g. T for the Transform tool).

  • Press Spacebar and the tool’s key together, e.g. Spacebar-T to select the Transform tool in one go.

Search:

Opens up the Menu Search. This option is good for someone who is new to Blender and is unfamiliar with the menus and shortcuts. Even if you don’t select this option, however, you can still access the search with F3.

If you select something other than Play, you can instead use Shift-Spacebar to start/stop playback.

Activate Gizmo Event

The activation event for gizmos that support drag motion. This option is only available when Select with Mouse Button is set to Left.

Press:

The gizmo’s operation gets initiated (and additional options become available in the Status Bar) the moment you press down the mouse button on the gizmo.

Drag:

The operation only gets initiated once you start dragging the gizmo.

Tool Keys

Determines the behavior of tool activation keyboard shortcuts.

Immediate:

The tool is immediately in use. For example, if you press Ctrl-B while editing a mesh, this will immediately initiate a Bevel: you can move the mouse to change the size and then click LMB to confirm.

Active Tool:

The tool is only selected (same behavior as if you were to click on it in the Toolbar). For example, if you press Ctrl-B while editing a mesh, the Bevel tool will be selected and the gizmo will become visible in the viewport; to actually perform a bevel, you then need to drag this gizmo.

Alt Click Tool Prompt

Tapping Alt shows a prompt in the status bar prompting a second keystroke to activate the tool. Note that this option is not available when using Emulate 3 Button Mouse.

Alt Tool Access

Hold Alt to use the Active Tool when the gizmo would normally be required. (For example, with the Move tool selected, you can hold Alt and drag the mouse anywhere in the viewport to move the selected object, rather than having to drag its gizmo.) This option is only available when Select with Mouse Button is set to Left and Emulate 3 Button Mouse is disabled.

Select All Toggles

Causes the Select All shortcut A to deselect all when any selection exists.

Region Toggle Pie

N opens a pie menu to toggle Regions rather than always toggling the Sidebar region.

This option is only available if the Developer Extras are enabled.

3D Viewport

Grave Accent / Tilde Action
Navigate:

Viewpoint pie menu, useful on systems without a numeric keypad.

Gizmos:

Transform gizmos pie menu, useful for quickly switching between transform gizmos. Note that this doesn’t apply to tools that force a certain gizmo (Move, Rotate, Scale and Transform); if you have such a tool selected, the gizmo will stay the same no matter what you choose in the pie menu.

Middle Mouse Action

The action when MMB dragging in the viewport. This also applies to trackpads.

Orbit:

Orbits the view around a central point. Shift-MMB is used for panning.

Pan:

Pans the view. Shift-MMB is used for orbiting.

Alt Middle Mouse Drag Action

How to determine the new viewpoint when dragging Alt-MMB in the viewport.

Relative:

The new viewpoint depends on both the mouse movement direction and the current viewpoint. For example, dragging the mouse horizontally rotates the viewpoint 90° around the view’s current vertical axis.

Absolute:

The new viewpoint only depends on the mouse movement direction. For example, dragging the mouse to the right always puts the viewpoint on the positive side of the global X axis.

Tab for Pie Menu

By default, Tab toggles Edit Mode and Ctrl-Tab opens a pie menu for selecting from all modes. This option flips these two shortcuts around.

Pie Menu on Drag

When enabled, certain keys get different behavior when tapped and show a pie menu when holding them and dragging the mouse.

Tab
Tap:

Toggle Edit Mode.

Drag:

Show Object Mode pie menu.

Z
Tap:

Toggle wireframe view.

Drag:

Show Viewport Shading pie menu.

AccentGrave
Tap:

Start first person Fly/Walk Navigation.

Drag:

Show viewpoint pie menu.

Extra Shading Pie Menu Items

Show additional items in the shading menu (Z key).

Transform Navigation with Alt

Requires additionally holding Alt to navigate the view while transforming something. In return, you don’t need to hold Alt to perform certain other operations.

As an example: if this option is disabled, dragging MMB always orbits the view, and when you’re moving an object, you can drag with Alt-MMB to lock the movement to an axis. If this option is enabled, these shortcuts get inverted while moving: MMB does the axis lock, and you need to use Alt-MMB to orbit, Shift-Alt-MMB to pan, and Alt-Wheel to zoom.

This also applies to Proportional Editing (where Wheel controls the size of the influence area) and Auto IK (where Wheel controls the length of the temporary IK chain). If the option is disabled, Wheel will zoom the view instead, and you need to use Alt-Wheel to change these properties.

File Browser

Open Folders on Single Click

Navigate into folders by clicking on them once instead of twice.

Editor

The Keymap editor lets you change the default hotkeys for each of Blender’s editors.

../../_images/editors_preferences_keymap_keymap-editor.png

Keymap editor.

Usage

  1. Find the operation whose shortcut you want to change. Filtering can help with this.

  2. Select whether the operation should be triggered by a keyboard key, a mouse button, or something else.

  3. Click the button on the right and press the shortcut you want to assign.

Aktiv

Uncheck the checkbox to disable this keymap item.

Map Type
Keyboard:

Single hotkey or key combination.

Mouse:

Actions from mouse buttons, tablet or touchpad input.

NDOF:

Movement or button from a 3D mouse (NDOF) device.

Tweak:

Mouse click and drag (optionally map drag direction to different actions).

Text Input:

Use this function by entering a text.

Timer:

For Blender internal use.

Operator ID Name

The identifier for the operator to call.

Hint

See bpy.ops for a list of operators (remove the bpy. prefix for the identifier).

Event
Type

The key or button that activates this keymap item (depending on the map type).

Value

The action (such as press, release, click, drag, etc.), (depending on the map type).

Modifier

Additional keys to hold (such as Ctrl, Shift, Alt).

Operator Properties

Initial values for the operator-specific properties.

Se også

Keymap Customization for more information on keymap editing.

Restoring

If you want to restore the default settings for a keymap, just click on the Restore button at the top right of this keymap.

Tips

Instead of changing the default keymap, you can also add a new one.

Known Limitations

Blender Versions

A problem with modifying your own keymap is that newer Blender versions may change the way tools are accessed, breaking your customized keymap.

While the keymap can be manually updated, the more customizations you make, the higher the chance of conflicts in newer Blender versions is.