Skip to content

First Launch and Preflight Checks

On first launch, OpenScreech can show the Preflight Checks window and keep the app focused until required setup is complete.

Preflight establishes that OpenScreech can listen, respond to its hotkeys, and run local speech recognition. It does not choose how a dictation should be processed. That behavior comes from the profile mapped to the hotkey you use.

What It Checks

  • Accessibility permission
  • Microphone permission
  • Local Parakeet v3 model presence

Typical Setup Sequence

  1. Open Accessibility settings and allow OpenScreech.
  2. Grant microphone access when prompted.
  3. Download the Parakeet v3 model from the preflight screen.
  4. Continue and finish onboarding.

Afterward, OpenScreech Home provides both the main quick-action dashboard and an embedded workspace. Select a primary feature in its sidebar to use it inside Home, or pop that same feature into a separate window when you need a multi-window layout. Frequent actions remain available from the menu bar, and Dock presence is enabled by default.

Reopening Later

Use menu item: Preflight Checks....

Next Step

After preflight is complete, continue with:

Notes

  • If permission prompts are stuck, a known reset command is:
  • tccutil reset All com.openscreech.app
  • You can keep using OpenScreech from its Home window, menu bar, Dock, or assigned hotkeys after checks pass.

Quick Tips

  • Preflight confirms microphone, Accessibility, and the main speech-recognition model. Optional diarisation and Screechback text-to-speech models are downloaded separately only when you choose them.
  • Passing Preflight proves that OpenScreech is ready to capture; it does not determine which profile a hotkey will use.

Visual Notes

  • TODO: add screenshot of preflight window with all three check rows.
  • TODO: add GIF of model download progress and ready state.