packages/docs/misc/keyboard-shortcuts.md
Nuclear comes with built-in keyboard shortcuts for common actions. You can customize any shortcut from the settings.
| Action | macOS | Windows / Linux |
|---|---|---|
| Play / Pause | Space | Space |
| Next track | ⌘ → | Ctrl → |
| Previous track | ⌘ ← | Ctrl ← |
| Seek forward | → | → |
| Seek backward | ← | ← |
| Volume up | ⌘ ↑ | Ctrl ↑ |
| Volume down | ⌘ ↓ | Ctrl ↓ |
| Mute / Unmute | ⌘ M | Ctrl M |
| Action | macOS | Windows / Linux |
|---|---|---|
| Open settings | ⌘ , | Ctrl , |
Seek forward and backward skip by the number of seconds configured in the Playback settings (default: 5 seconds). Volume changes in steps of 5%.
⌘/Ctrl + ,)Escape to cancel recording without savingIf the key combination you record is already used by another command, Nuclear will show an error and keep the previous binding.
To restore a single shortcut to its default, click the Reset button next to it. To restore all shortcuts at once, click Reset all to defaults at the bottom of the page.
Custom shortcuts are saved to shortcuts.json in your Nuclear config directory and persist across restarts.