Keyboard shortcuts¶
Every key Moonshine listens for, grouped by where it works.
Press ? anywhere in the app to see the built-in list, or open it from the ? menu in the top-right corner → Keyboard Shortcuts.
Before you start¶
- Modifier key. Where this page shows Ctrl, use Cmd on macOS. The app renders whichever one matches the machine you are on.
- Typing wins. No shortcut fires while the cursor is in a text field, a number field or a dropdown. Click away from the field first.
- Shortcuts are contextual. A key can mean different things in different tabs — P switches to the Pen tool in Mask and toggles the projector's eye view in Scene.
Global¶
These work from any tab.
| Key | What it does |
|---|---|
| G | Show or hide the scene graph panel along the bottom |
| \ | Show or hide the sidebar |
| 1 … 9 | Select the first through ninth projector in the list |
| Ctrl+Z | Undo |
| Ctrl+Shift+Z | Redo |
| ? | Open the keyboard shortcut list |
| / | Open the command palette |
The palette shortcut is not in the in-app list
/ opens the command palette everywhere in the app, but the built-in shortcut window does not list it. It works regardless.
How undo is routed. Ctrl+Z means different things depending on what you are editing, because each editor keeps its own history:
- In the Scene tab with the Warp tool active, undo and redo step through vertex edits.
- In the Mask tab, undo steps back through brush strokes and path edits. There is no redo in this tab — see below.
- Everywhere else, undo and redo step through your session's history of project edits — moving a projector, renaming, nudging keystone corners, and so on.
That last history belongs to your session: it holds the last hundred actions and is emptied when you switch projects or lose the connection to the show machine. Undoing writes the change back to the show machine like any other edit, so on a shared project undo what you just did, not what you did twenty minutes ago.
Scene tab¶
Modes and views¶
| Key | What it does |
|---|---|
| V | Object mode |
| E | Select mode |
| W | Warp mode |
| P | Look through the selected projector, or return to the free camera |
| F | Frame the current selection (pointer must be over the viewport) |
| Esc | Detach the gizmo, deselect the warp vertex, or leave the projector's eye view |
F frames whatever is selected — the active projector, the selected model, or the whole surface if nothing is selected. It does nothing while you are looking through a projector, since the view is fixed to the lens.
Esc steps back through those in order: it releases an attached gizmo first, then a selected warp vertex, then the projector view.
Moving a projector or a model¶
These act on whichever gizmo is attached — click a projector or a model first.
| Key | What it does |
|---|---|
| T | Move (translate) |
| R | Rotate |
| S | Scale |
| L | Switch the gizmo between world and local space |
| Shift (hold) | Fine control while dragging |
Holding Shift damps the drag to a tenth of its normal travel for move and rotate. Scale is always damped; Shift makes it ten times finer again.
Selecting and warping¶
| Key | What it does |
|---|---|
| [ / ] | Shrink / grow the selection radius |
| Alt+[ / Alt+] | Same, in much finer steps |
| X | Switch the selection mode between Add and Subtract |
| Up Down Left Right | Nudge the selected warp vertex |
| Shift+Up (etc.) | Nudge in finer steps |
Softness — the falloff at the edge of the radius — has no reliable key of its own. Use the Softness slider in the sidebar, directly under Radius.
Camera¶
| Action | What it does |
|---|---|
| Left-drag | Orbit |
| Right-drag | Pan |
| Scroll | Zoom |
Warp tab¶
The Warp tab has two editors and each has its own key set. Switch between them with the 4-Corner / Bezier Mesh control at the top of the sidebar.
4-Corner¶
| Key or action | What it does |
|---|---|
| Click | Select a corner |
| Drag | Move a corner |
| Up Down Left Right | Nudge the selected corner |
| Tab | Next corner |
| Shift+Tab | Previous corner |
| Esc | Deselect |
| Scroll | Zoom |
| Middle-drag | Pan |
Select a corner by clicking it before you reach for the keyboard — Tab and the arrow keys only act once a corner is selected. The nudge distance comes from the Arrow Key Sensitivity slider in the sidebar; turn it down for the final pass against a physical edge.
Bezier Mesh¶
| Key or action | What it does |
|---|---|
| Click | Select a point |
| Drag | Move a point or a handle |
| Up Down Left Right | Nudge the selected point, or its handle if a handle is selected |
| Tab | Next point |
| Shift+Tab | Previous point |
| H | Toggle the selected point's handles between Linked and Independent |
| Esc | Deselect |
| Scroll | Zoom |
| Middle-drag | Pan |
Click once inside the editor before using these — the bezier editor only receives keystrokes while it has focus. Nudge distance comes from this editor's own Arrow Key Sensitivity slider, which is separate from the 4-Corner one.
Mask tab¶
| Key or action | What it does |
|---|---|
| B | Brush tool |
| P | Pen tool |
| [ / ] | Brush size, in steps of 5 pixels (1–1000) |
| { / } | Brush size, one pixel at a time |
| , / . | Softer / harder brush edge |
| - / = | Less / more opacity, in steps of 10% |
| X | Switch between Paint and Erase |
| Shift-click | Draw a straight brush line from the last point you painted |
| Alt-drag a point | Convert a corner point to a smooth one and pull out handles |
| Alt-drag a handle | Break the handle pair's symmetry so one side moves alone |
| Click a line or path | Add it to, or remove it from, the selection |
| Del or Backspace | Delete the hovered or selected path (Pen tool) |
| Esc | Deselect everything |
| Ctrl+Z | Undo the last stroke or path edit |
The sidebar lists most of these under Shortcuts, under the brush sliders.
There is no redo in the Mask tab
Ctrl+Shift+Z does nothing here, and the mask editor has no redo button. Undo is one-way — if you step back too far, repaint rather than expecting to recover the stroke.
Scene graph¶
Hold the pointer over the graph panel for these.
| Key | What it does |
|---|---|
| F | Fit the whole graph in view |
| Del or Backspace | Remove the selected node, if it is a media item or playlist you dragged in |
The rest of the graph is drawn from the project — projectors, surfaces and their texture, warp and mask stages. Those nodes have no delete: remove the projector or the surface itself and the node goes with it.
Assets tab¶
| Key | What it does |
|---|---|
| Up / Down | Move the selection up and down |
| Left / Right | Move the selection sideways (grid view only — the list is one item wide) |
| Home / End | Jump to the first / last item |
| F2 or Enter | Rename the selected item |
| Esc | Close the full-screen preview, or clear the selection |
Esc takes one step at a time: the first press closes a full-screen preview, the second clears the selection.
Dialogs and the command palette¶
| Key | What it does |
|---|---|
| Esc | Close the open dialog, menu or palette |
| Up / Down | Move through the palette results |
| Enter | Run the highlighted command |