Your First Dictation¶
This guide has one goal: speak a sentence and watch it appear in another application.
You do not need to configure profiles, processing libraries, or output formats yet.
Before You Start¶
Complete First Launch and Preflight Checks so that:
- Microphone permission is granted.
- Accessibility permission is granted.
- The local Parakeet model is ready.
Use the Seeded Default¶
A new OpenScreech setup includes:
Right Command: push-and-hold dictation.Right Option: toggle dictation.
Both initially use the first profile, whose default behavior automatically pastes finished text. Start with Right Command because its beginning and end are easy to feel.
Make the First Dictation¶
- Open TextEdit, Notes, or another application with a text field.
- Click inside the text field and leave that application focused.
- Hold the Right Command key.
- When the overlay says
Listening, speak:
this is my first OpenScreech dictation
- Check that the audio meter moves while you speak.
- Release Right Command.
- Watch the overlay change to
Transcribingand thenPasting.
Expected result:
- The spoken sentence appears in the text field.
That is the complete basic workflow.
What You Just Used¶
Right Command → default Profile → local transcription → automatic paste
- The hotkey started and stopped recording.
- The overlay showed the active profile, microphone level, and current state.
- OpenScreech converted the audio to text locally.
- The default profile pasted the result into the focused application.
Cancel a Dictation¶
To stop without transcribing or pasting:
- Start another dictation.
- Press
Escape.
The overlay closes and nothing is pasted.
If Your Defaults Were Previously Changed¶
If Right Command does not start dictation:
- Open
Hotkeys->Manage Hotkeys.... - Find any enabled hotkey with a key assigned.
- Check whether it uses
Push and HoldorToggle. - Use that assigned key with the corresponding activation behavior.
If dictation works but nothing is pasted, check that Auto paste into active window is enabled on the profile mapped to that hotkey.
For additional diagnosis, see Troubleshooting.
Next Step¶
You have achieved the first goal. Continue to After Your First Dictation to learn:
- How hotkeys and profiles connect.
- Push-and-hold versus toggle.
- How to recall previous results with Left and Right Arrow.
- How to move and customize the overlay.
- Which feature to try next.
Quick Tips¶
- Make sure the intended destination application is focused before dictation finishes. Automatic paste is sent to the application active at paste time.
- Press
Escapewhile listening to cancel the active capture without transcribing or pasting it.
Visual Notes¶
- TODO: add a short GIF of Right Command, speaking, releasing, and pasting.
- TODO: add an annotated screenshot of the listening overlay.