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.
- Combo 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 Combo Mode hotkey | Toggle Combo Mode | Settings → Combo 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 up through results, or enter command history from the blank subject state |
| ↓ | Move down through results or an already-active history list |
| → | 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 using the selected item's text value |
| , | Stage the current selection in the focused pane |
| . | Switch the focused pane into Text Mode and keep the current query |
| ⌥+. | Apply the previous action and target to the current subject |
Command Shortcuts While Tuna Is Open
| Shortcut | What it does |
|---|---|
| ⌘+1 | Switch to Fuzzy Mode |
| ⌘+2 | Switch to Text Mode and keep the current query |
| ⌘+3 | Toggle Talk Mode |
| ⌘+4 | Switch to Combo Mode |
| ⌘+, | Open Settings |
| ⌘+G | Grab Current Selection into Tuna and keep focus on the same pane |
| ⌘+R | Rescan the library |
| ⌘+V | Paste text, files, or the current system selection into Tuna |
| ⌘+K | Open current command's context menu |
| ⌘+L | Open selected result's more menu |
| ⌘+Y | Toggle Quick Look for the selected item |
| ⌃+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 |
Combo Mode
| Shortcut | What it does |
|---|---|
| your Leader trigger | Enter or toggle Combo Mode |
| ⎋ | Exit Combo 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 Combo Mode open after the action runs |
By default Tuna uses:
- ⌃ to run groups.
- ⌥ to keep Combo 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 |
Combo Mode can use the same modifier-style trigger options, but Tuna does not let Talk Mode and Combo 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 |