Keyboard Shortcuts
Every keyboard shortcut in Spectralite Studio. You can also see and change them inside the app.
Spectralite Studio has the keyboard shortcuts below. To see them inside the app, open Window > Shortcuts (Cmd+/). To record a new key combination, click a shortcut in that dialog.
Global
| Action | Shortcut | Description |
|---|---|---|
| Save Project | Cmd+S | Save the current project |
| Save Copy | Cmd+Shift+S | Save a copy of the current project |
| Undo | Cmd+Z | Undo the last action |
| Redo | Cmd+Shift+Z | Redo the last undone action |
| Open Project | Cmd+O | Open an existing project |
| Startup Dialog | Cmd+Shift+O | Open the Startup Dialog to pick an example or recent project |
| Shortcuts | Cmd+/ | Show keyboard shortcuts dialog |
| Double BPM | ] | Double the current BPM |
| Halve BPM | [ | Halve the current BPM |
| Toggle Mapping Mode | Cmd+M | Enter or exit MIDI/DMX mapping mode |
Node Editor
| Action | Shortcut | Description |
|---|---|---|
| Add Node | Shift+A | Open the add node dialog at cursor position |
| Select Effect | Cmd+P | Open the effect selector dropdown |
| Group Selection | Cmd+G | Create a group from the selected nodes |
Timeline
| Action | Shortcut | Description |
|---|---|---|
| Add Layer | N | Open the add layer dialog |
| Delete Layer | ⌫ | Delete the selected layers, bumps and groups |
| Duplicate Layer | Cmd+D | Duplicate the selected layer |
| Group Layers | Cmd+G | Group the selected layers or bumps in a new group |
| Ungroup | Cmd+Shift+G | Ungroup the selected groups and keep their layers or bumps |
| Toggle Solo | S | Toggle solo on the selected layer |
| Toggle Lock | L | Toggle lock on the selected layer |
| Select Previous Layer | ↑ | Select the previous layer |
| Select Next Layer | ↓ | Select the next layer |
Preview
| Action | Shortcut | Description |
|---|---|---|
| Toggle Camera | C | Toggle between perspective and orthographic camera |
| Cycle Background | B | Cycle through background color options |
| Toggle Haze | H | Show or hide the light in the air |
Layout Editor
| Action | Shortcut | Description |
|---|---|---|
| Translate Mode | G | Switch to translate (move) mode |
| Scale Mode | S | Switch to scale mode |
| Rotate Mode | R | Switch to rotate mode |
| Toggle Snap | Shift+S | Toggle snap to grid |
| Toggle Labels | L | Toggle fixture labels in the Layout Editor and 3D Aim |
| Group Selection | Cmd+G | Group the selected parts of one fixture |
3D Aim
| Action | Shortcut | Description |
|---|---|---|
| Group Selection | Cmd+G | Create a position group from the selected fixtures |
| Duplicate Position | Cmd+D | Duplicate the selected position |
| Duplicate Group | Cmd+Shift+D | Duplicate the selected position group |
Panel-scoped key reuse
Some keys do different things in different panels. They do not conflict, because a key goes to one panel only.
Cmd+Gis used in node-editor, timeline, layout-editor, position-aim.Cmd+Dis used in timeline, position-aim.Sis used in timeline, layout-editor.Lis used in timeline, layout-editor.
Which panel gets a key
A panel's shortcuts act in one panel at a time. Spectralite picks the panel in this order:
- If the pointer is over a panel's work area, that panel gets the keys you press without
CmdorCtrl. This holds even when a control in another panel still has focus from an earlier click. The work areas are the Timeline's lanes, the Layout Editor's viewport, 3D Aim's viewport, the Preview and the node editor's canvas. - If a control inside a panel has focus, that panel gets the key. A button in the panel's toolbar counts.
- If nothing has focus, or the focus is in the top bar, the panel under the pointer gets the key.
While a dialog, menu or popover has focus, panel shortcuts do nothing. A text field always keeps the keys you type.
Moving between panels
Press F6 to move the focus to the next area of the main window. The order is the top bar, the Mapping Mode bar while it is on, each visible panel in turn, and then any notifications. Shift+F6 moves back. When the focus reaches a panel, that panel becomes the active one, and its shortcuts follow the focus from there. When you return to a panel, it gives the focus back to the control you last used in it. This does not happen if you hid the panel behind another tab, renamed it or popped it out in between. Popped-out panel windows have no F6 stops.
Copy and paste
Cmd+C, Cmd+X and Cmd+V copy, cut and paste what a panel has selected. Cut, Copy and Paste in the Edit menu do the same. Each panel copies one kind of item:
- The Node Editor copies the effect it shows.
- The Timeline and the Bumps panel copy the selected layer.
- The Layouts panel copies the selected layout.
- The MIDI Input window copies the selected mapping.
The keys go where Cmd shortcuts go. That is the panel that has focus. If no panel has focus, it is the panel under the pointer, and after that the panel you last clicked. A click in a panel counts as focus there until the focus moves again. This is also true on a canvas that keeps the focus where it was. The Edit menu in the menu bar acts on the panel or window you last clicked.
A text field keeps the ordinary text copy and paste. So does text that you select in the panel, or in the focused control, before you copy. This works only if you do not click anywhere between the selection and the copy.
A paste adds a new item and selects it. The new item has "(copy)" in its name, as with Duplicate. The items that were selected before stay as they were, and undo removes the new item. An item that you paste into another project loses its references to the effects, layouts, layers, fixtures and library colors that the project does not have. A notification says how many references it lost. A layer that loses its layout plays on the project's Stage layout.
An effect cannot be cut: remove it with Delete in the Node Editor's toolbar. A layer, a layout or a MIDI mapping can be cut, except a layout that a layer uses. While nodes are selected on the Node Editor's canvas, the keys leave the effect alone. The clipboard holds the item as text, so you can keep a copy in a file or a message and paste it back.
Key names
Shortcuts use the Mac key names. Cmd is the Command key (⌘ in the app's menus), Option is ⌥, Shift is ⇧, and Ctrl is Control (⌃).
How to Read These Docs
The formatting conventions repeated across Spectralite's documentation, covering menu paths, UI labels, and keyboard shortcuts.
Understanding DMX
An introduction to DMX512 for lighting control, covering channels, universes, fixture addressing, and how cabling and protocols connect them.