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

# Keyboard Shortcuts

> Complete keyboard shortcuts grouped by workflow for navigation, timeline, transcript, chat, overlays, and advanced tools.

## Overview

This page is the complete shortcut guide for the current app behavior.

It is grouped by workflow so you can find shortcuts the same way other professional tools do: navigation, playback, editing, transcript, chat, and specialized modes.

\[insert screenshot of keyboard shortcuts page grouped by workflow sections]

## Before You Start

* Most shortcuts work only when focus is on the editor/timeline and not inside text inputs.
* `Command` means Command on macOS.
* This page is macOS-only.

## Global App Navigation

| Action                   | Mac                              | Where it works   | Notes                               |
| ------------------------ | -------------------------------- | ---------------- | ----------------------------------- |
| New draft/project        | `Command + N`                    | App-wide         | Creates a new project.              |
| Close active project tab | `Command + W`                    | Project route    | Closes current project tab.         |
| Switch to previous tab   | `Command + Option + Left Arrow`  | App-wide tabbing | Moves to previous open project tab. |
| Switch to next tab       | `Command + Option + Right Arrow` | App-wide tabbing | Moves to next open project tab.     |

## Playback And Timeline

| Action                             | Mac                                  | Where it works  | Notes                                           |
| ---------------------------------- | ------------------------------------ | --------------- | ----------------------------------------------- |
| Play/pause                         | `Space`                              | Editor timeline | Primary transport control.                      |
| Pause immediately                  | `K`                                  | Editor timeline | Always pauses when shortcut handling is active. |
| Reverse playback                   | `J`                                  | Editor timeline | Repeat presses increase reverse speed.          |
| Slow reverse playback              | `Shift + J`                          | Editor timeline | Cycles through slower reverse speeds.           |
| Forward playback                   | `L`                                  | Editor timeline | Repeat presses increase forward speed.          |
| Slow forward playback              | `Shift + L`                          | Editor timeline | Cycles through slower forward speeds.           |
| Seek back 2 seconds                | `Shift + Space`                      | Editor timeline | Fast backward seek.                             |
| Seek by 2 seconds                  | `Shift + Left/Right Arrow`           | Editor timeline | Disabled while skip-segment mode is active.     |
| Jump by scene boundaries           | `Command + Shift + Left/Right Arrow` | Editor timeline | Moves to previous/next scene boundary.          |
| Seek back 2 seconds (alt combo)    | `Command + Shift + J`                | Editor timeline | Additional seek shortcut.                       |
| Seek forward 2 seconds (alt combo) | `Command + Shift + K`                | Editor timeline | Additional seek shortcut.                       |
| Timeline zoom in                   | `Command + =`                        | Timeline footer | Zooms in timeline view.                         |
| Timeline zoom out                  | `Command + -`                        | Timeline footer | Zooms out timeline view.                        |
| Zoom timeline to fit               | `F`                                  | Pro mode        | Fits timeline width to viewport.                |

## Insert And Editing

| Action                        | Mac                   | Where it works                        | Notes                                                |
| ----------------------------- | --------------------- | ------------------------------------- | ---------------------------------------------------- |
| Open/close insert launcher    | `Command + K`         | Editor                                | Opens launcher search.                               |
| Add zoom at playhead          | `Command + O`         | Editor                                | Adds zoom clip.                                      |
| Split recording clip          | `Command + Shift + S` | Editor                                | Splits active recording clip.                        |
| Toggle add skip segment mode  | `Command + E`         | Editor with screen/webcam at playhead | Opens skip workflow.                                 |
| Add sync point                | `Command + S`         | Screen recording at playhead          | Requires timestretch data and non-freeze position.   |
| Auto-time current screen clip | `Command + Shift + A` | Screen recording at playhead          | Requires timestretch data and not currently playing. |
| Undo                          | `Command + Z`         | Editor                                | Timeline-aware undo.                                 |
| Redo                          | `Command + Shift + Z` | Editor                                | Timeline-aware redo.                                 |
| Split scene                   | `Command + Shift + C` | Editor                                | Disabled during transcript free-edit mode.           |
| Delete selected clip/element  | `Backspace`           | Editor                                | Does not run while typing in inputs/editors.         |
| Copy selected clip context    | `Command + C`         | Editor                                | Runs only when no text selection/input focus.        |
| Add comment                   | `C`                   | Editor                                | Adds comment at current context.                     |

### Insert Launcher Navigation

When the insert launcher is open:

| Action            | Mac          |
| ----------------- | ------------ |
| Next item         | `Arrow Down` |
| Previous item     | `Arrow Up`   |
| Run selected item | `Enter`      |
| Close launcher    | `Escape`     |

\[insert screenshot of insert launcher with highlighted keyboard navigation]

## Pro Mode Shortcuts

| Action                      | Mac                           | Notes                                    |
| --------------------------- | ----------------------------- | ---------------------------------------- |
| Toggle Pro mode             | `Command + Shift + Backslash` | Turns Pro controls on/off.               |
| Toggle templates popover    | `S`                           | Pro mode only.                           |
| Insert text                 | `T`                           | Pro mode only.                           |
| Toggle image/video popover  | `I`                           | Pro mode only.                           |
| Toggle library dialog       | `Command + L`                 | Pro mode only.                           |
| Hold Shift for preview mode | `Shift` (hold)                | Shift-hold preview behavior in timeline. |

## Skip Segment Mode Shortcuts

These work only while add skip segment mode is active.

| Action                        | Mac                             | Notes                   |
| ----------------------------- | ------------------------------- | ----------------------- |
| Continuous fine seek backward | `Shift + Left Arrow` (hold)     | Accelerates while held. |
| Continuous fine seek forward  | `Shift + Right Arrow` (hold)    | Accelerates while held. |
| Jump back 1 second            | `Command + Shift + Left Arrow`  | Large jump.             |
| Jump forward 1 second         | `Command + Shift + Right Arrow` | Large jump.             |
| Add skip segment              | `Enter`                         | Commits skip segment.   |
| Exit skip mode                | `Escape`                        | Leaves skip workflow.   |

## Slide Canvas And Overlay Editing

These shortcuts apply when slide/canvas elements are selected in the editor canvas.

| Action                        | Mac                   | Notes                                      |
| ----------------------------- | --------------------- | ------------------------------------------ |
| Duplicate selected items      | `Command + D`         | Duplicates selected slide elements/groups. |
| Group selected items          | `Command + G`         | Creates a layout group.                    |
| Ungroup selected layout group | `Command + Shift + G` | Requires a selected layout group.          |
| Nudge selection               | `Arrow keys`          | Moves by 1px.                              |
| Nudge selection faster        | `Shift + Arrow keys`  | Moves by 10px.                             |

The same arrow-key nudge behavior is used for captions when the captions resizer is selected.

## Transcript Shortcuts

### Transcript Panel Core

| Action                              | Mac               | Notes                                |
| ----------------------------------- | ----------------- | ------------------------------------ |
| Toggle transcript free-edit mode    | `Option + C`      | Global transcript toggle.            |
| Play clip at cursor                 | `Command + Enter` | Works in transcript editor context.  |
| Regenerate clip at cursor           | `Shift + Enter`   | Works in transcript editor context.  |
| Play/pause clip at cursor           | `Option + Space`  | Transcript keymap shortcut.          |
| Alternate play/pause clip at cursor | `Option + Enter`  | Alternate transcript shortcut.       |
| Toggle bold word/selection          | `Command + B`     | Transcript text formatting behavior. |

### Transcript Chunk Dropdown (When Open)

| Action              | Mac               |
| ------------------- | ----------------- |
| Preview/pause chunk | `Command + Enter` |
| Regenerate chunk    | `Shift + Enter`   |
| Close dropdown      | `Escape`          |

### Free-Edit Constraints (Important)

While transcript free-edit mode is active:

* `Command + V` paste is intentionally blocked.
* `Command + A` select-all is intentionally blocked.
* In standard and variable-webcam groups, typing is blocked; navigation/copy is still allowed.
* `Enter` and `Backspace/Delete` use transcript-specific split/merge behaviors inside webcam recording groups.

## Chat And Comments

### Chat Panel

| Action                    | Mac             | Notes                                           |
| ------------------------- | --------------- | ----------------------------------------------- |
| Focus/open chat flow      | `Tab`           | Behavior depends on left/right chat panel mode. |
| Clear active conversation | `Command + T`   | Works when chat is open.                        |
| Send message              | `Enter`         | In chat input.                                  |
| New line in message       | `Shift + Enter` | In chat input.                                  |
| Blur/collapse input       | `Escape`        | In chat input.                                  |

### Comment Input

| Action           | Mac             | Notes                                                    |
| ---------------- | --------------- | -------------------------------------------------------- |
| Submit comment   | `Enter`         | If mention/emoji picker is not currently handling Enter. |
| New line         | `Shift + Enter` | Adds line break.                                         |
| Cancel edit mode | `Escape`        | Edit mode only.                                          |

## Chart Spreadsheet Shortcuts

These shortcuts apply when a chart spreadsheet has focus.

| Action                            | Mac                            |
| --------------------------------- | ------------------------------ |
| Enter edit mode / commit and move | `Enter`                        |
| Move active cell                  | `Arrow keys`                   |
| Extend selection                  | `Shift + Arrow keys`           |
| Extend selection to edge          | `Command + Shift + Arrow keys` |
| Select all cells                  | `Command + A`                  |
| Clear active/selected cells       | `Backspace`                    |
| Type into active cell             | `Type any valid character`     |

## Dialog-Specific Shortcuts

| Action                     | Mac          | Scope                            |
| -------------------------- | ------------ | -------------------------------- |
| Play/pause video           | `Space`      | Basic video trim modal.          |
| Play/pause video           | `Space`      | Generations dialog video player. |
| Select previous generation | `Arrow Up`   | Generations list.                |
| Select next generation     | `Arrow Down` | Generations list.                |

## Camera Editor Shortcut

| Action                          | Mac             | Notes                                                 |
| ------------------------------- | --------------- | ----------------------------------------------------- |
| Show transform panel while held | `Option` (hold) | Temporarily reveals transform controls when eligible. |

## Admin And Internal Shortcuts

These are primarily operational/internal and may change.

| Action                                 | Mac                   | Availability             |
| -------------------------------------- | --------------------- | ------------------------ |
| Toggle timeline backups panel          | `Command + Shift + 9` | Editor internal tooling. |
| Toggle timestretch dev mode            | `Command + Shift + 8` | Editor internal tooling. |
| Fetch timestretch timeline at playhead | `Command + Shift + 7` | Demo mode only.          |
| Toggle demo mode                       | `Command + Shift + 0` | Domain-gated.            |
| Toggle admin login form                | `Command + Shift + 9` | Login page only.         |

## Where Shortcuts Are Blocked

Shortcut behavior is intentionally blocked or changed in these cases:

* Focus is inside `input`, `textarea`, transcript editor (`ProseMirror`), right panel controls, or spreadsheet cells.
* Collab generations dialog is open.
* Basic trim modal is open.
* Force-update modal is open (it captures and blocks keyboard events).
* Mode-gated shortcuts are used outside their required mode (Pro mode, skip mode, transcript context, demo mode).

## Troubleshooting

### Shortcut does nothing

Click the timeline/canvas first, then retry. Most failures are focus-related.

### Transcript shortcut behaves differently than timeline shortcut

Transcript keymaps are context-specific. Shortcuts like `Command + Enter`, `Shift + Enter`, and `Option + Space` work when the transcript editor has focus.

### Enter in transcript does something unexpected

`Enter` in transcript is context aware and can split clips/chunks depending on where the cursor is. This is expected behavior.

## Next

See [Pro Tips](/pro-tips) for workflow speed-ups that pair well with these shortcuts.
