# OCR capture

Extract text from any region of your screen using built-in OCR (Optical Character Recognition).

## How to use

1. Open the system tray menu and select **OCR Capture** (or press the default shortcut, `⌘⇧O` on macOS or `Ctrl+Shift+O` on Windows)
2. Click and drag to select the area containing text
3. Release to run OCR — recognized text is copied to your clipboard automatically
4. Optionally, the text opens in your configured text editor

## Requirements

OCR Capture is available when your platform supports native text detection:

- **macOS** — Uses the built-in Vision framework
- **Windows** — Uses Windows OCR APIs

If OCR is not available on your platform, the menu item and toolbar button are hidden.

## OCR in the editor

You can also run OCR on an existing capture from the editor:

1. Set an artboard crop around the text you want to extract
2. Click the **OCR** button in the toolbar
3. Recognized text is copied to your clipboard

## OCR settings

Configure OCR behavior in **Settings → OCR**:

### OCR text editor

Choose which application opens the extracted `.txt` file after OCR runs. Leave blank to use the system default text editor.

### Open text editor on capture

When enabled (the default), the recognized text file is automatically opened in your text editor after being copied to the clipboard.

### Remove line breaks

When enabled, line breaks are removed from the recognized text.

## Hotkey

OCR Capture has a default hotkey, which you can change in **Settings → Shortcuts**:

| Action | macOS | Windows |
|--------|-------|---------|
| OCR Capture | `⌘⇧O` | `Ctrl+Shift+O` |

## Tips

- **Select tight** — Crop close to the text for better accuracy
- **High contrast works best** — Dark text on light backgrounds gives the best results
- **Multiple lines** — OCR handles multi-line text selections
- **Clipboard first** — Text is always copied to clipboard, even if the editor is disabled

---

*See also: [Area Capture](/docs/hypershot/capturing/area-capture ) | [Preferences](/docs/hypershot/settings/preferences )*

---

From https://hypernuclear.com/docs/hypershot/capturing/ocr-capture/