Keyboard Shortcuts
This page is a reference.
Some Tuna shortcuts are fixed. Others depend on your settings:
- Global launch hotkeys are user-defined.
- A few Fuzzy Mode keys change based on your preferences.
- Leader Mode bindings are customizable, but Tuna ships with a default root keymap.
Global Hotkeys
| Shortcut | What it does | Where to set it |
|---|---|---|
| your Fuzzy Mode hotkey | Open Tuna in Fuzzy Mode | Settings → Hotkeys |
| your Text Mode hotkey | Open Tuna in Text Mode | Settings → Hotkeys |
| your Leader Mode hotkey | Toggle Leader Mode | Settings → Leader Mode when Trigger is Hotkey style
|
| your Talk Mode hotkey | Start Talk Mode | Settings → Talk Mode when Trigger is Hotkey style
|
| your custom command hotkeys | Run any Tuna command from anywhere | Settings → Hotkeys |
Hyper Key
Tuna supports Hyper shortcuts like any other key combination:
⌃+⌥+⇧+⌘
If you already remap a physical key to Hyper with another tool, Tuna can use those shortcuts for:
- global mode hotkeys
- custom command hotkeys
- any other Tuna shortcut recorder
Tuna does not currently remap a physical key to Hyper itself. Use Raycast, Karabiner, Hammerspoon, or another external tool if you want Caps Lock or another key to act as Hyper.
Talk Mode hotkeys can work in two ways:
- Hold to talk: hold the hotkey to record, release to stop.
- Toggle: press once to start recording, press again to stop.
Core Launcher Keys
| Shortcut | What it does |
|---|---|
| ↩ | Commit the current selection or command |
| ⎋ | Close Tuna |
| ⇥ | Move focus to the next pane |
| ⇧+⇥ | Move focus to the previous pane |
| ↑ / ↓ | Move through results |
| → | Enter the selected result, browse into it, or move right in grids |
| ← | Go up one level when browsing, or move left in grids |
| ' | Switch the focused pane into Text Mode and start editing |
| , | Stage the current selection in the focused pane |
| . | Repeat the last action |
| ⌃+Space | Toggle Quick Look for the selected item |
Command Shortcuts While Tuna Is Open
| Shortcut | What it does |
|---|---|
| ⌘+1 | Switch to Fuzzy Mode |
| ⌘+2 | Switch to Text Mode |
| ⌘+3 | Switch to Leader Mode |
| ⌘+4 | Toggle Talk Mode |
| ⌘+, | Open Settings |
| ⌘+R | Rescan the library |
| ⌘+V | Paste text, files, or the current system selection into Tuna |
| ⌘+K | Open the selected result's context menu |
| ⌘+L | Open the selected result's More menu |
| ⌃+O | Cycle result sorting when Tuna has multiple sort modes available |
Text Editing
These work while you are editing text inside Tuna.
| Shortcut | What it does |
|---|---|
| ⎋ | Leave text editing and keep Tuna open |
| ⌘+Z | Undo |
| ⌘+⇧+Z | Redo |
| ⌘+X | Cut |
| ⌘+C | Copy |
| ⌘+V | Paste |
| ⌘+A | Select all |
Fuzzy Mode Settings That Change Keys
| Setting | Default | What changes |
|---|---|---|
| Backspace behavior | Clear search | ⌫ clears the current query instead of deleting one character at a time |
| Backspace behavior: Delete characters | Off by default | ⌫ removes one character and ⌘+⌫ clears the focused query |
| Spacebar behavior | Normal | Space inserts a space into the current query |
| Spacebar behavior: Switch to Text Mode | Optional | Space switches the subject pane into Text Mode |
| Spacebar behavior: Jump to Target Pane | Optional | Space selects the first target-capable action and moves focus to the target pane |
Alternative Result Navigation
| Setting | Shortcuts |
|---|---|
| Arrow Keys Only | ↑ ↓ ← → |
| macOS / Emacs | ⌃+N ⌃+P ⌃+F ⌃+B |
| Vim Style | ⌃+J ⌃+K ⌃+L ⌃+H |
Leader Mode
| Shortcut | What it does |
|---|---|
| your Leader trigger | Enter or toggle Leader Mode |
| ⎋ | Exit Leader Mode |
| ? | Show the Leader cheatsheet immediately |
| ⌫ | Reset to root by default, or step back one level if you changed that setting |
| hold the group modifier | Run every action inside the matched group |
| hold the sticky modifier while committing | Keep Leader Mode open after the action runs |
By default Tuna uses:
- ⌃ to run groups.
- ⌥ to keep Leader Mode open after a command.
If you use Modifier style instead of Hotkey style, hold the selected modifier and press a layer 0 key to run that root action directly.
Default Leader Root Map
This is the shipped default. You can edit it or replace it by importing your own config.
| Key | Default action |
|---|---|
| s | Safari |
| t | Terminal |
| f | Finder |
| m | Messages |
| n | Notes |
| d | Downloads folder |
| h | Home folder |
Talk Mode Modifier Triggers
This only applies if Talk Mode is set to Modifier style.
| Trigger | What it does |
|---|---|
| Right ⌘ | Hold to record, release to transcribe |
| Right ⌥ | Hold to record, release to transcribe |
| Right ⌘ + Right ⌥ | Hold both to record, release to transcribe |
| Hyper (⌘+⌥+⌃+⇧) | Hold Hyper to record, release to transcribe |
Leader Mode can use the same modifier-style trigger options, but Tuna does not let Talk Mode and Leader Mode share the same modifier at the same time.
App And Menu Shortcuts
| Shortcut | What it does |
|---|---|
| ⌘+, | Open Settings |
| ⌘+⌥+S | Toggle Shelf |
| ⌘+W | Close the Tuna window |
| ⌘+Q | Quit Tuna |