# Keyboard Shortcuts

Muximux includes a set of keyboard shortcuts for fast navigation and control. All shortcuts can be customized or disabled as needed.

## Default Keyboard Shortcuts

### Navigation

| Shortcut | Action |
|----------|--------|
| `Ctrl+K` | Open Command Palette |
| `S` | Open Settings |
| `?` | Show Keyboard Shortcuts Help |
| `L` | Toggle Logs (press again to return to your app) |
| `H` | Toggle Overview (press again to return to your app) |

### Actions

| Shortcut | Action |
|----------|--------|
| `R` | Refresh Current App |
| `F` | Toggle Fullscreen (hide navigation) |
| `N` | Next App |
| `P` | Previous App |
| `1` - `9` | Jump to App (apps with an assigned shortcut) |

**Note:** Keyboard shortcuts are only active when the Muximux UI itself is focused. When an iframe app has focus, keystrokes are sent to that app instead. Click outside the iframe or press `Escape` to return focus to Muximux.

## Command Palette

The command palette (opened with `Ctrl+K`) provides quick access to apps and actions without navigating through menus.

The palette supports the following:

- **App search** -- Type an app name to quickly switch to it. Recently used apps appear first.
- **Actions** -- Open Settings, Show Shortcuts, Toggle Fullscreen, Refresh, View Logs, Go Home.
- **Theme commands** -- Set Dark Theme, Set Light Theme, Use System Theme.

Use the **arrow keys** to navigate results, **Enter** to select, and **Escape** to close.

## Keyboard Navigation

Muximux can be used without a mouse:

- **Tab** and **Shift+Tab** move between controls. The control with keyboard focus always shows the same visible outline (in the theme's `--border-focus` colour).
- **Dialogs** (Settings, the Discover dialog, confirmations, the onboarding wizard and the others) keep focus inside while they are open: Tab wraps around within the dialog, the page behind it cannot be reached, and closing it returns focus to the control that opened it. **Escape** closes the topmost dialog; for an icon picker or other sub-dialog opened over a dialog, it closes only that sub-dialog.
- **Health status.** Focusing an app in the navigation, or a health dot on the overview, opens its health tooltip; **Escape** hides it. The tooltip's "Check now" action is mouse-only for now.
- **Logs.** The log list can be focused and scrolled with the arrow and Page keys.
- **Command palette.** `Ctrl+K`, then the arrow keys, **Enter** and **Escape** (see above).

Screen readers hear errors as alerts and confirmations as status messages, and icon-only buttons have names. Muximux also honours the operating system's reduced-motion setting, and every bundled theme meets WCAG 2.1 AA contrast. See [Themes > Focus, motion and screen readers](themes.md#focus-motion-and-screen-readers).

## Customizing Shortcuts

You can customize any keyboard shortcut through the Settings panel:

1. Open **Settings > Keybindings** tab.
2. Click on the shortcut you want to change.
3. Press the new key combination you want to assign.
4. Toggle modifier keys (Ctrl, Alt, Shift, Meta) as needed.
5. You can assign multiple key combinations to a single action.
6. Reset individual bindings or all bindings to their defaults.

Custom keybindings are saved in `config.yaml` under `keybindings.bindings`:

```yaml
keybindings:
  bindings:
    refresh:
      - key: "F5"
    settings:
      - key: ","
        ctrl: true
```

Only customized bindings are stored in the configuration file. Any action that is not listed will continue to use its default shortcut.

## Assigning Number Keys to Apps

Keys `1` through `9` switch to apps that have an explicit `shortcut` assignment. During onboarding, shortcuts are automatically assigned to the first 9 apps. After that, you manage them manually -- assigning a number to a new app removes it from whichever app previously held it.

```yaml
apps:
  - name: Plex
    url: http://plex:32400
    shortcut: 1              # Accessible via key "1"

  - name: Sonarr
    url: http://sonarr:8989
    shortcut: 5              # Accessible via key "5"
```

Only apps with an explicit `shortcut` value respond to number keys. Apps without a shortcut have no number key binding. The splash screen badges reflect this -- only apps with assigned shortcuts show a number badge.

You can also assign shortcuts in **Settings > Keybindings** without editing the config file.

---

## Import and Export Keybindings

The Settings panel provides options to export your keybinding configuration as JSON and import it on another Muximux instance. This is useful for keeping a consistent shortcut layout across multiple installations.