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:
Checking microphone: OpenScreech is preparing the selected input.Preparing speech model…: recording is already active while the local recognition model finishes loading.Listening (Profile Name): recording is active and the named profile will handle the result.Transcribing: speech is being converted into text locally.Processing: optional profile processing is running.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:
Once those work, choose a practical direction:
- Dictate Prompts for AI Tools
- Hear Summaries and Responses
- Dictate into Documents
- Notes
- Long-form recording for meetings, or Record a Podcast for separate microphones on one interface
- Transcribe existing files
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.