Skip to content

Meet OpenScreech

OpenScreech is a local-first voice work parrot for macOS: built to turn speech into useful text, recordings, notes, and automated workflows.

You do not need to understand every feature before you begin. Start by learning the four parts you will use for ordinary dictation.

The Four Basic Parts

Part What It Does
OpenScreech Home Combines quick actions with an embedded workspace for the app's main capture, processing, library, and settings tools
Menu bar Keeps frequent actions, profiles, history, and app status close while you work
Hotkey Starts and stops dictation without opening a window
Overlay Shows what OpenScreech is hearing and doing during dictation

Dock presence is enabled by default. You can open Home from the Dock or menu bar, but you normally do not need Home open while dictating. Home's sidebar can collapse to icons when you want more working space. A primary feature can remain in Home's right pane or move into a separate window and later dock back into Home with the same current state.

How a Dictation Works

Press hotkey → Speak → Finish hotkey → Transcribe → Paste

The hotkey also selects a profile. That profile controls how the text is processed and delivered, but the seeded defaults are ready for a straightforward first dictation. You can learn profile configuration after the first success.

Understanding the Overlay

The overlay appears when dictation begins. It is your immediate feedback that OpenScreech is active.

Overlay Element What It Tells You
Status line The current step, such as Checking microphone, Preparing speech model…, Listening (Default), Transcribing, Processing, or Pasting
Profile name The profile selected by the hotkey, shown in the listening status
Audio meter Whether OpenScreech is receiving your voice; it should move while you speak
Transcript area Live preview text and then the finalized result
Hint lines The active profile and up to two available profile quick-switch keys

Common states:

  1. Checking microphone: OpenScreech is preparing the selected input.
  2. Preparing speech model…: recording is already active while the local recognition model finishes loading.
  3. Listening (Profile Name): recording is active and the named profile will handle the result.
  4. Transcribing: speech is being converted into text locally.
  5. Processing: optional profile processing is running.
  6. Pasting: the finished text is being inserted into the active application.

You can drag the live overlay to another position. Profiles can remember that position and use their own colours, but those are later customization choices.

Press Escape during active dictation to cancel without pasting.

Your First Path

Follow these guides in order:

  1. First Launch and Preflight Checks
  2. Your First Dictation
  3. After Your First Dictation

Once those work, choose a practical direction:

A Few Terms for Later

Term Meaning
ASR Automatic speech recognition: converting voice into text
Profile A saved mode controlling how one dictation is processed and delivered
Auto paste Automatically inserting the finished text into the active application
Temporary history Up to ten recent finalized results kept in memory for quick reuse
Notes Persistent, searchable capture bundles stored on disk
Screechback Local text-to-speech playback of a selected profile result

The full glossary explains the advanced language when you need it.

In-App Help

Many management and settings windows have:

  • ? buttons with detailed explanations
  • Hover tooltips for controls and actions

See In-App Help Cues when exploring configuration.

Quick Tips

  • The profile name in the listening status answers “what will happen if I finish now?” It updates when you use a profile quick-switch key.
  • The audio meter is independent of the transcript preview. Meter movement confirms microphone input even when recognizable preview words have not appeared yet.

Visual Notes

  • TODO: add an annotated screenshot of OpenScreech Home, the menu bar, and the overlay.
  • TODO: add a short GIF showing Listening, Transcribing, and Pasting.