Getting Started
Getting Started
After installing Voxclip, follow these steps to make your first transcription. Everything runs locally — no accounts or API keys needed.
Verify the installation
voxclip versionDownload a speech model
voxclip setupThis downloads and verifies the default model (tiny on Linux, small on macOS). Models are stored in:
- Linux:
$XDG_DATA_HOME/voxclip/modelsor~/.local/share/voxclip/models - macOS:
~/Library/Application Support/voxclip/models
Record and transcribe
voxclipThis runs the default flow:
- Record — captures audio from your microphone
- Transcribe — processes the audio with the speech model
- Copy — puts the transcript on your clipboard
Press Enter to start recording, then Enter again to stop. The transcript prints in the terminal and is copied to your clipboard.
Next steps
- Explore the full command reference
- Configure your recording backend
- Check troubleshooting if something goes wrong