Keyboard Shortcuts and Keymap Customization

ArmorPaint’s input system is fully driven by a keymap: every action — from painting and camera navigation to toggling panels and invoking tools — is bound to a configurable key or mouse combination. The active keymap is loaded from a JSON preset file stored in the keymap_presets/ folder inside the application data directory. You can switch presets, edit individual bindings, create new presets, and import or export keymap files, all from Preferences → Keymap (Ctrl+K).

Default Shortcuts

The tables below list every action registered in the default keymap (default.json). Bindings with an empty value have no default key assigned and must be set manually.

File

Action	Default Binding	Description
`file_new`	`Ctrl`+`N`	Create a new project
`file_open`	`Ctrl`+`O`	Open a project file
`file_open_recent`	`Ctrl`+`Shift`+`O`	Open a recent project
`file_save`	`Ctrl`+`S`	Save the current project
`file_save_as`	`Ctrl`+`Shift`+`S`	Save the project to a new file
`file_reimport_mesh`	`Ctrl`+`R`	Reimport the source mesh
`file_reimport_textures`	`Ctrl`+`Shift`+`R`	Reimport source textures
`file_import_assets`	`Ctrl`+`I`	Import assets (textures, meshes, etc.)
`file_export_textures`	`Ctrl`+`E`	Export textures to the last used path
`file_export_textures_as`	`Ctrl`+`Shift`+`E`	Export textures and choose destination

Edit

Action	Default Binding	Description
`edit_undo`	`Ctrl`+`Z`	Undo the last paint operation
`edit_redo`	`Ctrl`+`Shift`+`Z`	Redo a previously undone operation
`edit_prefs`	`Ctrl`+`K`	Open the Preferences dialog

View

Action	Default Binding	Description
`view_reset`	`0`	Reset viewport to default perspective
`view_front`	`1`	Front orthographic view
`view_back`	`Ctrl`+`1`	Back orthographic view
`view_right`	`3`	Right orthographic view
`view_left`	`Ctrl`+`3`	Left orthographic view
`view_top`	`7`	Top orthographic view
`view_bottom`	`Ctrl`+`7`	Bottom orthographic view
`view_camera_type`	`5`	Toggle between perspective and orthographic
`view_orbit_left`	`4`	Orbit camera left
`view_orbit_right`	`6`	Orbit camera right
`view_orbit_up`	`8`	Orbit camera up
`view_orbit_down`	`2`	Orbit camera down
`view_orbit_opposite`	`9`	Orbit to the opposite side
`view_zoom_in`	(unbound)	Zoom in
`view_zoom_out`	(unbound)	Zoom out
`view_distract_free`	`F11`	Toggle distraction-free / fullscreen mode
`view_pivot_center`	`Alt`+`Middle Mouse`	Set the camera pivot to the view center

Viewport

Action	Default Binding	Description
`viewport_mode`	`Ctrl`+`M`	Cycle through viewport display modes

Toggle Panels

Action	Default Binding	Description
`toggle_node_editor`	`Tab`	Show / hide the material node editor
`toggle_2d_view`	`Shift`+`Tab`	Show / hide the 2D UV view
`toggle_browser`	` (backtick)	Show / hide the asset browser

Tools

Action	Default Binding	Description
`tool_brush`	`B`	Activate the Brush tool
`tool_eraser`	`E`	Activate the Eraser tool
`tool_fill`	`G`	Activate the Fill tool
`tool_decal`	`D`	Activate the Decal tool
`tool_text`	`T`	Activate the Text tool
`tool_clone`	`L`	Activate the Clone tool
`tool_blur`	`U`	Activate the Blur tool
`tool_particle`	`P`	Activate the Particle tool
`tool_colorid`	`C`	Activate the Color ID tool
`tool_picker`	`V`	Activate the Color Picker tool
`tool_cursor`	`R`	Activate the Cursor / Transform tool
`tool_select`	`M`	Activate the Select tool
`tool_material`	(unbound)	Activate the Material Paint tool
`swap_brush_eraser`	(unbound)	Swap between Brush and Eraser

Brush

Action	Default Binding	Description
`brush_radius`	`F`	Drag to resize the brush radius interactively
`brush_radius_decrease`	`[`	Decrease brush radius by one step
`brush_radius_increase`	`]`	Increase brush radius by one step
`brush_opacity`	`Shift`+`F`	Drag to adjust brush opacity interactively
`brush_angle`	`Alt`+`F`	Drag to rotate the brush angle interactively
`brush_ruler`	`Shift`	Hold to constrain stroke to a straight line

Paint Actions

Action	Default Binding	Description
`action_paint`	`Left Mouse`	Apply the active tool to the surface
`action_rotate`	`Alt`+`Left Mouse`	Rotate the viewport camera
`action_pan`	`Alt`+`Middle Mouse`	Pan the viewport camera
`action_zoom`	`Alt`+`Right Mouse`	Zoom the viewport camera
`rotate_envmap`	`Ctrl`+`Middle Mouse`	Rotate the environment / HDRI map
`set_clone_source`	`Alt`	Set the clone source point (Clone tool)

Stencil

Action	Default Binding	Description
`stencil_transform`	`Ctrl`	Hold to enter stencil transform mode (move/scale/rotate)
`stencil_hide`	`Z`	Toggle stencil visibility

Decal

Action	Default Binding	Description
`decal_mask`	`Ctrl`	Hold to mask the decal projection
`decal_camera_align`	`Z`	Align the decal to the camera view

Action	Default Binding	Description
`grid_snap`	`X`	Toggle grid snapping
`select_material`	`Shift`+`Number`	Select a material by index
`select_layer`	`Alt`+`Number`	Select a layer by index
`node_overview`	`Z`	Zoom to fit all nodes in the node editor
`node_search`	`Space`	Open the node search popup
`operator_search`	`Space`	Open the operator / command search popup

Keymap Presets

ArmorPaint ships with three built-in presets. The active preset is selected from Preferences → Keymap → Preset.

default.json

The standard ArmorPaint binding set described in the tables above. Used on all desktop platforms unless overridden.

blender.json

A Blender-compatible binding set. Key differences from the default:

action_rotate → Middle Mouse
action_pan → Shift+Middle Mouse
action_zoom → Ctrl+Middle Mouse
rotate_envmap → Ctrl+Right Mouse

touch.json

Optimized for touch screens and graphics tablets. Used by default on Android and iOS. Key differences:

action_rotate → Left Mouse (single touch drag)
action_pan → Right Mouse
action_zoom → (unbound — use pinch gesture)

Custom Keymaps

You can create a custom keymap that overrides only the bindings you want to change — all other actions fall back to the default.json values automatically.

Create a new preset

Open Preferences → Keymap and click New. Enter a name (e.g. my_keymap) and click OK. A new JSON file is written to the keymap_presets/ folder, initialized with the complete default binding set.

Edit bindings

Each action appears as an editable text field. Click a field and type the new key combination, then press Enter. The binding is saved immediately. Use modifier prefixes: ctrl+, shift+, alt+, and mouse buttons left, middle, right.

{
  "file_save": "ctrl+s",
  "brush_radius": "r",
  "brush_radius_decrease": "minus",
  "brush_radius_increase": "equal"
}

Import or export

Use the Export button to save a copy of the current preset to any location, and Import to load a .json keymap file from disk into the presets folder. Imported files are copied to keymap_presets/ and immediately selectable from the Preset dropdown.

Switch the active preset

Select your preset from the Preset dropdown in Preferences → Keymap. The change takes effect instantly — no restart required.

Keymap File Format

A keymap JSON file is a flat object mapping action names to key combination strings. Only the keys you wish to override need to be included; the rest use the defaults.

{
  "file_new": "ctrl+n",
  "file_open": "ctrl+o",
  "file_save": "ctrl+s",
  "edit_undo": "ctrl+z",
  "edit_redo": "ctrl+shift+z",
  "brush_radius": "f",
  "tool_brush": "b",
  "tool_eraser": "e",
  "action_paint": "left",
  "action_rotate": "alt+left",
  "action_pan": "alt+middle",
  "action_zoom": "alt+right"
}

Custom keymap files saved to the keymap_presets/ data folder are preserved across ArmorPaint updates. Back up this folder alongside your project files to retain your bindings.

Binding two different actions to the same key combination may cause unpredictable behavior. ArmorPaint does not currently warn about duplicate bindings.

Getting Started

Painting

Node Editor

Rendering & Baking

Import & Export

Configuration

Keyboard Shortcuts and Keymap Customization

Default Shortcuts

File

Edit

View

Viewport

Toggle Panels

Tools

Brush

Paint Actions

Stencil

Decal

Selection & Navigation

Keymap Presets

default.json

blender.json

touch.json

Custom Keymaps

Keymap File Format

Build docs developers (and LLMs) love

Getting Started

Painting

Node Editor

Rendering & Baking

Import & Export

Configuration

Documentation Index

​Default Shortcuts

​File

​Edit

​View

​Viewport

​Toggle Panels

​Tools

​Brush

​Paint Actions

​Stencil

​Decal

​Selection & Navigation

​Keymap Presets

default.json

blender.json

touch.json

​Custom Keymaps

​Keymap File Format

Build docs developers (and LLMs) love

Default Shortcuts

File

Edit

View

Viewport

Toggle Panels

Tools

Brush

Paint Actions

Stencil

Decal

Selection & Navigation

Keymap Presets

Custom Keymaps

Keymap File Format