Skip to content

Quick Start

Set up your microphone and transcription model, then make your first Yap dictation on macOS, Windows, or Linux.

Launch and finish setup

Install Yap, then open it from Applications, the Start menu, or your Linux launcher. Follow onboarding and allow microphone access. On macOS, enable Accessibility for the global hotkey and auto-paste.

The latest release is 0.5.0. Screenshots show the release React UI with sample data. See release status.

Choose how to transcribe

For local transcription, download a model during onboarding or on the Models page. Start with base.en for English or a model without .en for other languages. Wait until the model is ready before recording. No separate Whisper installation is needed with release packages.

Downloading on the Models page does not activate a model: choose Use this model afterward. Onboarding activates the model selected in that flow.

For OpenAI transcription, choose the cloud provider in Settings and save your own API key. This requires an internet connection and separately billed OpenAI usage. See transcription.

Make your first recording

  1. Open a text field in another app and place the cursor where your words should go.
  2. Press Right Option on macOS, or Right Alt on Windows/Linux, unless you changed your recording key.
  3. Speak a short sentence.
  4. Press the same key again to stop and transcribe. Escape cancels by default.
  5. Check the result. Auto-paste inserts it when enabled; otherwise paste from the clipboard using Cmd+V or Ctrl+V.

You can also start recording from Yap’s Home screen. Choose your microphone in Settings if the wrong input is being used. Linux’s global-key and simulated-paste workflow requires X11; see platform setup.

Yap Home with recording, settings, models, and history shortcuts

Yap 0.5.0 Home, captured from the release React UI with sample data.

Make it yours