Docs Reference
Keyboard shortcuts
Keyboard shortcuts for LumaSync — global commands, mode switcher, room map editor 50-step undo/redo and object tools, plus the tray context menu entries.
Global shortcuts (app-wide)
| Shortcut | Action |
|---|---|
Cmd+, / Alt+, | Open Settings |
Cmd/Ctrl + / | Toggle compact ↔ full mode |
Cmd/Ctrl + W | Hide window to tray (window stays running; v1.5.2 fires a one-shot OS notification the first time so you know the app is still alive) |
Cmd/Ctrl + Q | Quit LumaSync (kills the tray; v1.5.2 unifies Cmd+Q, tray Quit, and Ctrl+C onto a single watchdog-bounded shutdown path) |
On macOS the Cmd modifier; on Windows / Linux Ctrl. The Settings shortcut is Cmd+, on macOS and Alt+, on Windows / Linux.
From v1.5.2, the global shortcuts use TR-layout-safe key resolution — physical key position, not the character the layout produces — so Alt+, fires on Turkish Q and F keyboards even though the comma sits on a different physical key. An input-focus guard also suppresses the shortcuts while a text input, textarea, or the Cmd+K search modal is focused, so typing a comma in a search query never accidentally opens Settings.
Lights section (compact + full)
| Shortcut | Action |
|---|---|
Alt+1 / Cmd+1 | Off mode |
Alt+2 / Cmd+2 | Ambilight mode |
Alt+3 / Cmd+3 | Solid mode |
↑ / ↓ (Solid mode only) | Brightness ± 5% |
On macOS use the Cmd modifier; on Windows / Linux use Alt. Same input-focus guard as the global shortcuts — mode switching is blocked while you’re typing in a field.
Compact-mode deep links
From v1.5.2, deep-linking into a non-LIGHTS section while the app is in compact mode (320×480) auto-expands the window to full mode (900×620) so the target panel actually fits. The Settings shortcut (Cmd+, / Alt+,), the tray menu’s Open Settings entry, and any URL-style deep link land you on the requested section in full mode rather than a clipped compact view.
Room map editor
From v1.5.2 the room map editor ships with a full shortcut set:
| Shortcut | Action |
|---|---|
Cmd/Ctrl + Z | Undo (50 steps back) |
Cmd/Ctrl + Shift + Z | Redo |
Cmd/Ctrl + D | Duplicate selected object |
Delete / Backspace | Delete selected object |
Arrow keys | Nudge 1 px |
Shift + Arrow | Nudge 10 px |
L | Toggle lock on selection |
[ | Send object backward in z-order |
] | Bring object forward in z-order |
Cmd/Ctrl + 0 | Fit canvas to view |
Space + drag | Pan canvas |
| Middle-mouse drag | Pan canvas |
| Scroll wheel | Zoom (0.5×–3×, mouse-centered) |
| Right-click on object | Context menu (duplicate / delete / lock / z-order / rename / rotate) |
Tray menu
Right-click the tray icon for a context menu with these entries (all keyboard-accessible once the menu is open):
- Open Settings — brings the main window forward
- Lights off — switches mode to Off
- Resume last mode — restores the mode that was active before Off
- Solid color — jumps straight to Solid mode picker
- Quit — kills the tray and all pipeline threads
The IDs of these entries are defined in src/shared/contracts/shell.ts under TRAY_MENU_IDS if you’re scripting anything against them externally.
Related
- Config file — where shortcut customisations would persist (none configurable in v1.5.2)
- Tray-first UX — why the tray exists