Commands & Flags
Commands & Flags
Commands
| Command | Description |
|---|---|
voxclip | Run the default flow (record → transcribe → copy) |
voxclip record | Record audio to WAV |
voxclip transcribe <audio-file> | Transcribe existing audio |
voxclip devices | List recording devices and backend diagnostics |
voxclip setup | Download and verify model assets |
voxclip version | Show version information |
For complete flag reference, run voxclip --help and voxclip <command> --help.
Models
| Model | Approx. size | Default on |
|---|---|---|
| tiny | 75 MB | Linux |
| base | 142 MB | |
| small | 466 MB | macOS |
| medium | 1.5 GB | |
| large-v3 | 3.1 GB |
Select a model with --model <name> or pass a local file path.
Default-flow flags
These flags apply to the main voxclip command:
| Flag | Description |
|---|---|
--model <name|path> | Select a model name (tiny, base, small, medium, large-v3) or local model path (default: small on macOS, tiny on Linux) |
--model-dir <path> | Override model storage directory |
--language <auto|en|de|...> | Set transcription language |
--auto-download | Automatically download a missing model |
--backend <auto|pw-record|arecord|ffmpeg> | Choose recording backend |
--input <selector> | Choose input device |
--input-format <pulse|alsa> | Force ffmpeg input format on Linux |
--copy-empty | Copy blank transcripts to clipboard |
--copy-newline | Append a trailing newline to the clipboard text |
--silence-gate | Enable near-silent WAV detection before transcription |
--silence-threshold-dbfs <value> | Set silence-gate threshold |
--duration <duration> | Set fixed recording duration (e.g. 10s) |
--immediate | Start recording immediately |
--pid-file <path> | Write PID to file and wait for SIGUSR1 to stop recording (for toggle-style hotkey workflows) |
--no-progress | Disable spinner/progress indicators |
--verbose | Enable verbose logs |
--json | Output logs in JSON format |
Command-specific flags
Each subcommand has its own flags:
voxclip record --help— recording-only flags such as--outputvoxclip transcribe --help— transcription/copy flags such as--copyvoxclip setup --help— model setup flags onlyvoxclip devices --help— no operational flags
Input device selection
voxclip --input ":1"Use the device index from voxclip devices.