> ## Documentation Index
> Fetch the complete documentation index at: https://docs.otter-shell.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Keybinds

> In-app shortcuts for Otter Shell apps, plus compositor global hotkey examples for Hyprland, Sway, and other Wayland compositors.

In-app shortcuts live in each app's config file. Edit them in [otter-settings](/desktop/otter-settings) or in the `.conf` file directly. Global hotkeys go in your compositor.

## In-app shortcuts

| App              | Action                  | Default shortcut                     |
| ---------------- | ----------------------- | ------------------------------------ |
| otter-term       | Copy selection          | `Ctrl+Shift+C`                       |
| otter-term       | Paste                   | `Ctrl+Shift+V`                       |
| otter-term       | Context menu            | Right-click                          |
| otter-note       | Save note               | `Ctrl+S`                             |
| otter-note       | Toggle Markdown preview | `Ctrl+M`                             |
| otter-screenshot | Cancel region selection | `Esc` or `Ctrl+C`                    |
| otter-launcher   | Close                   | `Escape`                             |
| otter-launcher   | Launch selected         | `Enter`                              |
| otter-launcher   | Navigate                | `Up` / `Down`, `Tab`, `Page Up/Down` |
| otter-launcher   | Clear search            | `Ctrl+U`                             |
| otter-lock       | Submit password         | `Enter`                              |
| otter-polkit     | Submit password         | `Enter`                              |
| otter-polkit     | Cancel                  | `Escape`                             |

## otter-term keybinds

Edit in otter-settings under **Terminal**, or in `~/.config/otter-shell/otter-term.conf`:

```conf theme={null}
keybinds_copy  = "ctrl+shift+c"
keybinds_paste = "ctrl+shift+v"
```

Use lowercase key names with `+` as the separator.

## Recommended global hotkeys

Bind in your compositor config. Adjust modifiers to match your setup.

### Hyprland

```ini theme={null}
# ~/.config/hypr/hyprland.conf
bind = $mainMod, D, exec, otter-launcher
bind = $mainMod, P, exec, otter-screenshot
bind = $mainMod SHIFT, P, exec, otter-screenshot --fullscreen --output ~/Pictures/screenshot.png
bind = $mainMod, R, exec, otter-rec
bind = $mainMod, N, exec, otter-note new
bind = $mainMod, V, exec, otter-clip popup
bind = $mainMod SHIFT, C, exec, otter-pick
bind = $mainMod SHIFT, A, exec, otter-clicker toggle
bind = $mainMod, L, exec, loginctl lock-session
bind = $mainMod SHIFT, E, exec, otter-logout
```

Transcription (requires `otter-shell-extras`):

```ini theme={null}
bind = $mainMod, T, exec, otter-transcribectl toggle
```

### Sway

```
bindsym $mod+d exec otter-launcher
bindsym $mod+p exec otter-screenshot
bindsym $mod+Shift+p exec otter-screenshot --fullscreen --output ~/Pictures/screenshot.png
bindsym $mod+r exec otter-rec
bindsym $mod+n exec otter-note new
bindsym $mod+v exec otter-clip popup
bindsym $mod+Shift+c exec otter-pick
bindsym $mod+Shift+a exec otter-clicker toggle
bindsym $mod+l exec loginctl lock-session
```

## Recommended autostart

Add to compositor autostart so the shell is ready at login. See [Session setup](/desktop/session-setup) for compositor-specific syntax.

```bash theme={null}
# Core shell daemons
otter-bar &
otter-wallpaper &
otter-notifications &
otter-osd &
otter-idle &
otter-polkit &

# Clipboard and weather cache
otter-clip daemon &
otter-weather --watch 900 --write-cache &

# Optional: desktop pet
otter-jade &

# Optional: transcription (otter-shell-extras)
otter-transcribe &
```

| Service                               | Purpose                                                |
| ------------------------------------- | ------------------------------------------------------ |
| `otter-bar`                           | Status bar; tray, clock, weather                       |
| `otter-wallpaper`                     | Desktop background                                     |
| `otter-notifications`                 | `notify-send` and app alerts                           |
| `otter-osd`                           | Volume/brightness overlays (bar scroll, `otter-timer`) |
| `otter-idle`                          | Idle timeouts, DPMS, lock-on-idle                      |
| `otter-polkit`                        | Privilege dialogs (`pkexec`, package installs)         |
| `otter-clip daemon`                   | Clipboard history for `otter-clip popup`               |
| `otter-weather --watch --write-cache` | Bar weather widget cache                               |

The `&` suffix runs each process in the background.