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 (app-wide)
| Shortcut | Action |
|---|---|
Cmd+, / Alt+, | Open Settings |
Cmd/Ctrl + / | Toggle compact ↔ full mode |
Cmd/Ctrl + W | Hide window to tray (window stays running) |
Cmd/Ctrl + Q | Quit LumaSync (kills the tray) |
On macOS the Cmd modifier; on Windows / Linux Ctrl. The Settings
shortcut is Cmd+, on macOS and Alt+, on Windows / Linux.
From v1.4.0, 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.
Room map editor
From v1.4.0 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.4.0)
- Tray-first UX — why the tray exists