Navigation & Keymaps

Navigation & Keymaps

OxyBrush offers intuitive camera navigation, tablet pen integration, and fully customizable hotkeys. You can use the default navigation scheme or switch to popular DCC presets like Blender or Maya.

---

Viewport Navigation

Default Navigation Scheme

Action	Mouse / Pen Shortcut	Description
Orbit Camera	Right-click + Drag (or Alt + Left-click + Drag)	Rotates the camera around the current orbit pivot point.
Pan Camera	Middle-click + Drag (or Shift + Right-click + Drag)	Translates the camera horizontally and vertically.
Zoom / Dolly	Scroll Wheel (or Ctrl + Right-click + Drag)	Zooms camera closer to or farther from the focal point.
Snap Camera	NumPad 1 / 3 / 7 (or Alt-release near axis)	Snaps camera to Front (1), Right (3), or Top (7) orthographic views.
Frame Mesh	F (when not resizing brush) or . (NumPad Period)	Centers and frames the active mesh in the viewport.

Blender / Maya Style Preset (MMB Navigation)

If you are accustomed to Blender, Maya, or ZBrush:

1. Open Settings > Keymap Preferences.
2. Select the Blender / Standard DCC preset.
3. In this mode:
   • Orbit: Middle Mouse Button (MMB) + Drag
   • Pan: Shift + MMB + Drag
   • Zoom: Ctrl + MMB + Drag or Mouse Wheel
   • Snap View: Alt + MMB + Drag

---

Pen Tablet & Stylus Setup

OxyBrush natively supports Wacom, Huion, XP-Pen, and Apple Pencil (via Sidecar) with full pressure sensitivity for both brush radius and deformation strength.

Recommended Tablet Settings

• Stylus Tip: Normal click (Sculpt stroke).
• Lower Barrel Button: Right-click (Orbit viewport) or Middle-click.
• Upper Barrel Button: Ctrl or Alt (Invert stroke or engage Masking).
• Tablet Properties Tip: In your tablet driver settings, ensure Windows Ink is enabled on Windows if experiencing cursor jumping, or enable "Use Native Stylus Events" in Settings > Input.

---

Global Hotkeys Quick Reference

General & Project

Hotkey	Action
Ctrl + N	New Scene / Project
Ctrl + O	Open Project (.oxy)
Ctrl + S	Save Project
Ctrl + Shift + S	Save As
Ctrl + Z	Undo
Ctrl + Y / Ctrl + Shift + Z	Redo
Space	Quick Radial Pie Menu / Tool HUD
Tab	Toggle Fullscreen / Minimal Viewport Mode

Brush Adjustments

Hotkey	Action
F	Interactive Brush Radius (hold and move mouse, click to confirm)
Shift + F	Interactive Brush Strength / Intensity
[ / ]	Decrease / Increase brush radius step by step
Alt (hold)	Invert brush action (e.g., carve instead of add, pinch instead of inflate)
Shift (hold)	Temporary Smooth brush (smooths active deformation while held)
Ctrl (hold)	Temporary Masking brush (paints mask values)
Ctrl + Alt (hold)	Unmasking brush (erases painted mask)

Sculpting Brushes

Hotkey	Brush
1	Draw Brush
2 or C	Clay Brush
3	Clay Strips Brush
4 or S	Smooth Brush
5 or I	Inflate Brush
6 or G	Grab Brush
7	Flatten Brush
8 or P	Pinch Brush
9 or Shift + C	Crease Brush
0	Layer Brush
K	Snake Hook Brush
T	Transform Gizmo

Topology & Masking

Hotkey	Action
X	Toggle Mirror Symmetry (X-axis)
D	Step Up one subdivision level
Shift + D	Step Down one subdivision level
Ctrl + D	Add new Multires subdivision level
Ctrl + R	Trigger Voxel Remesh
Ctrl + A	Invert Mask
Ctrl + Shift + A	Clear Mask
Ctrl + W	Convert current mask to a new Face Group
H	Hide masked vertices
Alt + H	Unhide all vertices

---

Customizing Keymaps

To configure custom shortcuts:

1. Navigate to Edit > Preferences > Keymap (or press Ctrl + ,).
2. Type any command name in the filter bar (e.g., "Remesh", "Smooth", "Camera").
3. Click on the key assignment box and press the new shortcut combination on your keyboard or tablet.
4. OxyBrush will automatically highlight conflicts if the key is already in use.
5. Click Save User Keymap to persist your preferences. Custom keymaps are saved as JSON in your local configuration directory (~/.config/oxybrush/keymaps.json on Linux, %APPDATA%\oxybrush\keymaps.json on Windows).