# Keyboard shortcuts

Nuclear comes with built-in keyboard shortcuts for common actions. You can customize any shortcut from the settings.

## Default shortcuts

### Playback

| 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`      |

### General

| 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%.

## Customizing shortcuts

1. Open settings (`⌘`/`Ctrl` + `,`)
2. Click the **Key Shortcuts** tab (keyboard icon)
3. Click any keybinding to enter recording mode
4. Press the new key combination you want to use
5. Press `Escape` to cancel recording without saving

If 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nuclearplayer.com/nuclear/misc/keyboard-shortcuts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.