Keyboard Shortcuts

← Home

Keyboard Shortcuts

• Cheat Sheet
• File
• Window & Layout
• Navigation
• Shading & Inspection
• Show / Overlays
• Mesh Visibility
• Review
• Lighting & Post-Processing
• UV Map mode
• Analyze TUI

This page mirrors the in-app Keyboard Shortcuts overlay (?) and additionally documents a few bindings the overlay doesn't list (the W view-mode cycle, the T/F/L/R preset views, and arrow-key camera movement).

Ctrl/⌘ means Ctrl on Windows / Linux, ⌘ on macOS.

Note: User-remappable shortcuts are planned for a future release; the bindings on this page are fixed in v0.6.0. Press ? while the GUI is focused to open the same reference inside Solarxy.

Esc no longer quits. Open modals (Preferences, Update, About, Keyboard Shortcuts, file dialogs) dismiss with Esc. To exit the app, close the window or use File → Quit.

Cheat Sheet

A single reference table covering every binding in the GUI viewer.

Key	Action
Ctrl/⌘+O	Open model
Ctrl/⌘+Shift+O	Import HDRI
Ctrl/⌘+,	Open Preferences modal
Ctrl/⌘+1	Toggle the Viewport panel
Ctrl/⌘+L	Link cameras (split view)
C	Screenshot - opens the screenshot review modal
F1 / F2 / F3 / F4 / F5	Single / Split Vertical / Split Horizontal / Quad / Three-Left-Big
F10	Toggle menu bar
F11	Toggle fullscreen
Tab	Toggle sidebar
`	Toggle console
?	Open Keyboard Shortcuts overlay
Esc	Dismiss open modal
Left drag	Orbit · Middle / Shift+left drag - Pan · Scroll wheel - Zoom
H	Frame model
T / F / L / R	Top / Front / Left / Right preset view
Arrow keys	Move the camera
V	Toggle turntable
P / O	Perspective / Orthographic projection
W	Cycle view mode (Shaded / Shaded+Wire / Wireframe)
S	Force Shaded
X	Toggle Ghosted
1-7	Inspection: Shaded / Material ID / UV Map / Texel Density / Depth / Overdraw / AO Preview
M	Toggle material override Textured ↔ Clay Light
Shift+M	Cycle material override (Textured → Clay Light → Clay Dark → Chrome → Silhouette)
G	Grid
A / Shift+A	Axis gizmo / Local axes
N	Cycle normals (Off / Face / Vertex / Face+Vertex)
U	Cycle UV overlay (Off / Gradient / Checker)
B	Cycle background
Shift+B	Cycle bounds (Off / Whole Model / Per Mesh)
Shift+W	Cycle wireframe weight (Light / Medium / Bold)
Shift+V	Toggle validation overlay
Shift+H	Hide mesh under cursor
Alt+H	Show all meshes
/	Isolate mesh under cursor
Right-click	Mesh context menu
Shift+R	Toggle review mode
Ctrl/⌘+S	Save review sidecar (in review mode)
Ctrl/⌘+Enter	Save the open review-annotation popup
I / Shift+I	Cycle IBL / cycle IBL mode (Off / Diffuse / Full)
Shift+L	Lock lights
Shift+D	Toggle bloom
Shift+O	Toggle SSAO
Shift+T	Cycle tone mapping (None / Linear / Reinhard / ACES Filmic)
E / Shift+E	Raise / lower exposure

File

Key	Action
Ctrl/⌘+O	Open model (native dialog)
Ctrl/⌘+Shift+O	Import HDRI / EXR environment map
C	Screenshot - opens the screenshot review modal (nothing is written until you choose Save As…)
Ctrl/⌘+,	Open the Preferences modal

Window & Layout

Key	Action
F1	Single viewport
F2	Split Vertical (two panes side by side)
F3	Split Horizontal (two panes stacked)
F4	Quad viewport (2×2)
F5	Three-Left-Big viewport
F10	Toggle menu bar
F11	Toggle borderless fullscreen
Tab	Toggle the Sidebar panel
`	Toggle the Console panel
Ctrl/⌘+1	Toggle the Viewport panel
?	Open the Keyboard Shortcuts overlay
Esc	Dismiss the open modal

The Window menu carries the panel-visibility toggles (Viewport, Sidebar, Outliner, Properties, Review Panel, Material Inspector, Console, Status Bar, Menu Bar); the Layout menu carries the F1-F5 layouts plus Save / Restore / Reset Layout.

Navigation

Input	Action
Left drag	Orbit the camera
Middle drag / Shift+left drag	Pan the camera
Scroll wheel	Zoom
H	Frame the model (reset view to its bounding box)
T / F / L / R	Top / Front / Left / Right preset view
Arrow keys	Move the camera
V	Toggle turntable rotation
P / O	Perspective / Orthographic projection
Ctrl/⌘+L	Link cameras (split view only)

In split view the active pane follows the cursor; each pane's camera, inspection mode, and display settings are independent unless cameras are linked.

Shading & Inspection

Key	Action
W	Cycle view mode (Shaded → Shaded+Wire → Wireframe). While Ghosted, toggles the ghosted wireframe.
S	Force Shaded
X	Toggle Ghosted view
1	Inspection: Shaded (default PBR)
2	Inspection: Material ID (flat per-material colour)
3	Toggle UV Map ↔ 3D pane mode
4	Inspection: Texel Density (heat map)
5	Inspection: Depth (linearized)
6	Inspection: Overdraw (per-pixel draw count)
7	Inspection: AO Preview (raw SSAO, bypasses tone mapping)
M	Toggle material override Textured ↔ Clay Light
Shift+M	Cycle material override (Textured → Clay Light → Clay Dark → Chrome → Silhouette)

Show / Overlays

Key	Action
G	Grid
A	Axis gizmo
Shift+A	Local axes (per-mesh)
N	Cycle normals (Off / Face / Vertex / Face+Vertex)
U	Cycle UV overlay (Off / Gradient / Checker)
B	Cycle background (White / Gradient / Dark / Ayu Mirage / Black / HDRI Sky, plus any custom backgrounds)
Shift+B	Cycle bounds (Off / Whole Model / Per Mesh)
Shift+W	Cycle wireframe weight (Light / Medium / Bold)
Shift+V	Toggle the validation overlay (colour-coded issues on the mesh)

HDRI Sky joins the B cycle only once an HDRI is loaded.

Mesh Visibility

Key	Action
Shift+H	Hide the mesh under the cursor
Alt+H	Show all meshes
/	Isolate the mesh under the cursor (hide all others)
Right-click	Open the mesh context menu - Frame / Hide / Hide Others / Show All

Mesh visibility is also controllable from the Outliner panel.

Review

In-context annotation system. See Review System for the full workflow.

Key	Action
Shift+R	Toggle review mode on / off
Left click	Select a marker within ~20 px, or anchor a new annotation on the surface under the cursor
Ctrl/⌘+Enter	Save the open annotation popup
Ctrl/⌘+S	Save the review sidecar (only consumes Ctrl/⌘+S while review mode is active)
Esc	Cancel popup → close delete-confirm → cancel re-anchor → exit review mode (priority chain)

Lighting & Post-Processing

Key	Action
I	Toggle IBL on / off
Shift+I	Cycle the IBL mode (Diffuse / Full)
Shift+L	Lock lights (freeze the rig relative to the model)
Shift+D	Toggle bloom
Shift+O	Toggle SSAO
Shift+T	Cycle tone mapping (None / Linear / Reinhard / ACES Filmic)
E / Shift+E	Raise / lower exposure

UV Map mode

When the active pane is in UV Map mode (3 toggles it), a few keys are repurposed:

Key	Action
U	Cycle the UV background (Dark / Charcoal / Gray / Checker / Texture)
O	Toggle UV-overlap detection
3	Return to 3D view

Mouse drag and scroll pan and zoom the UV-space camera.

Analyze TUI

solarxy-cli --mode analyze -m <model> opens a four-tab terminal report.

Key	Action
Tab / Shift+Tab	Next / previous tab
1 / 2 / 3 / 4	Jump to a tab (Overview / Meshes / Materials / Validation)
j / k, ↓ / ↑	Scroll one line
g / G	Top / bottom
PgDn / PgUp	Scroll 20 lines
e	Export a text report (prompts for a filename)
J	Export a JSON report (prompts for a filename)
q / Esc	Quit

See also: User Guide · CLI Reference · Review System