Skip to main content
In-app shortcuts live in each app’s config file. Edit them in otter-settings or in the .conf file directly. Global hotkeys go in your compositor.

​
In-app shortcuts

AppActionDefault shortcut
otter-termCopy selectionCtrl+Shift+C
otter-termPasteCtrl+Shift+V
otter-termContext menuRight-click
otter-noteSave noteCtrl+S
otter-noteToggle Markdown previewCtrl+M
otter-screenshotCancel region selectionEsc or Ctrl+C
otter-launcherCloseEscape
otter-launcherLaunch selectedEnter
otter-launcherNavigateUp / Down, Tab, Page Up/Down
otter-launcherClear searchCtrl+U
otter-lockSubmit passwordEnter
otter-polkitSubmit passwordEnter
otter-polkitCancelEscape

​
otter-term keybinds

Edit in otter-settings under Terminal, or in ~/.config/otter-shell/otter-term.conf: 
keybinds_copy  = "ctrl+shift+c"
keybinds_paste = "ctrl+shift+v"
Use lowercase key names with + as the separator. Bind in your compositor config. Adjust modifiers to match your setup.

​
Hyprland

# ~/.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, L, exec, loginctl lock-session
bind = $mainMod SHIFT, E, exec, otter-logout
Transcription (requires otter-shell-extras): 
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+l exec loginctl lock-session
Add to compositor autostart so the shell is ready at login. See Session setup for compositor-specific syntax. 
# 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 &
ServicePurpose
otter-barStatus bar; tray, clock, weather
otter-wallpaperDesktop background
otter-notificationsnotify-send and app alerts
otter-osdVolume/brightness overlays (bar scroll, otter-timer)
otter-idleIdle timeouts, DPMS, lock-on-idle
otter-polkitPrivilege dialogs (pkexec, package installs)
otter-clip daemonClipboard history for otter-clip popup
otter-weather --watch --write-cacheBar weather widget cache
The & suffix runs each process in the background.