Speech-to-text commands
Transcribe a file
Transcribe a URL
Live microphone
Stream from your default microphone:
Press Ctrl+C to stop. On Linux with a pip, pipx, or uv install, --mic needs the PortAudio library; see Installation.
stdin / Piped Input
Pipe audio from another tool:
dg listen - reads raw audio from stdin. dg listen with no source opens an interactive source picker.
Options
Output format
Without -o, dg listen on a terminal prints a summary table and the transcript. -o json and -o yaml print the server’s prerecorded response body as sent, formatted as JSON or YAML; -o table and -o csv are no-ops on dg listen and print that same default summary instead. If a script expects the older, SDK-parsed JSON shape (indented, with datetime-style timestamps), set DEEPCTL_LISTEN_JSON=sdk to restore it.
dg listen also accepts a local text format for the transcript alone. It only works after the subcommand (dg listen audio.mp3 -o text); the global -o text placed before the subcommand fails, because text isn’t a valid value for --output at the root level.
-o works before the subcommand (dg -o json read ...) or after it on most commands (dg read ... -o json). On dg speak, -o/--output after the subcommand still sets the output file path but is deprecated; use --out-file instead. On dg plugin and dg skills subcommands, put -o before the subcommand.
In an AI-agent session, a prerecorded result over 64 KiB saves to a file under ~/.deepctl/results/ instead of printing, with a summary on stdout; pass --full-output to print the full payload anyway.
--timeout sets how many seconds dg listen waits at each step (connecting, sending, the response) for a file or URL source, not a cap on the whole run. Default 300, minimum 1; it doesn’t apply to --mic or live stdin.
Model Selection
nova-3 is the default and the model to use for new builds:
--model (-m) also accepts nova-2 and whisper for workloads that already depend on them. dg models --type stt lists the speech-to-text models your key can use; see Account Management.
Flux STT
- Flux STT runs on live audio (
--micor stdin). A file or URL exits1withFlux STT (flux-general-en) is streaming-only and cannot transcribe a file or URL.followed byUse a live source (--mic, stdin, or '-'), or pick a v1 model (e.g. nova-3) for pre-recorded audio. --diarizeis ignored with a warning.--channelsmust be1.--redactaccepts onlynumbersandaggressive_numbers.
Features
--smart-format and --punctuate are on by default. --sentiment, --topics, and --summarize apply to pre-recorded audio only; --interim applies to live streaming only.
For raw stdin, --sample-rate defaults to 16000 Hz and --channels defaults to 1. --encoding isn’t auto-detected: omitting it assumes linear16 and prints WARN: No --encoding specified — assuming linear16. Pass --encoding to suppress this warning. on stderr; pass --encoding explicitly for mulaw, opus, or any other non-Linear16 stream. --language defaults to en-US and --model to nova-3.
Subtitles
--webvtt and --srt work on their own; --diarize is optional and only adds speaker labels to the caption entries.
--webvttand--srtare mutually exclusive.- WebVTT output carries its metadata in a
NOTEblock. - In live mode (
--micor stdin), caption entries print as they arrive:
Language
Boolean options
Boolean options don’t take a value:
Run dg listen --help for the complete set of supported CLI options. The command doesn’t forward arbitrary API parameters.
Command alias
dg transcribe is a deprecated alias for dg listen: