CLI
Commands
add
Start a new transcription task.
Usage: buzz add [options] [file url file...]
Options:
-t, --task <task> The task to perform. Allowed: translate,
transcribe. Default: transcribe.
-m, --model-type <model-type> Model type. Allowed: whisper, whispercpp,
huggingface, fasterwhisper, openaiapi. Default:
whisper.
-s, --model-size <model-size> Model size. Use only when --model-type is
whisper, whispercpp, or fasterwhisper. Allowed:
tiny, base, small, medium, large. Default:
tiny.
--hfid <id> Hugging Face model ID. Use only when
--model-type is huggingface. Example:
"openai/whisper-tiny"
-l, --language <code> Language code. Allowed: af (Afrikaans), am
(Amharic), ar (Arabic), as (Assamese), az
(Azerbaijani), ba (Bashkir), be (Belarusian),
bg (Bulgarian), bn (Bengali), bo (Tibetan), br
(Breton), bs (Bosnian), ca (Catalan), cs
(Czech), cy (Welsh), da (Danish), de (German),
el (Greek), en (English), es (Spanish), et
(Estonian), eu (Basque), fa (Persian), fi
(Finnish), fo (Faroese), fr (French), gl
(Galician), gu (Gujarati), ha (Hausa), haw
(Hawaiian), he (Hebrew), hi (Hindi), hr
(Croatian), ht (Haitian Creole), hu
(Hungarian), hy (Armenian), id (Indonesian), is
(Icelandic), it (Italian), ja (Japanese), jw
(Javanese), ka (Georgian), kk (Kazakh), km
(Khmer), kn (Kannada), ko (Korean), la (Latin),
lb (Luxembourgish), ln (Lingala), lo (Lao), lt
(Lithuanian), lv (Latvian), mg (Malagasy), mi
(Maori), mk (Macedonian), ml (Malayalam), mn
(Mongolian), mr (Marathi), ms (Malay), mt
(Maltese), my (Myanmar), ne (Nepali), nl
(Dutch), nn (Nynorsk), no (Norwegian), oc
(Occitan), pa (Punjabi), pl (Polish), ps
(Pashto), pt (Portuguese), ro (Romanian), ru
(Russian), sa (Sanskrit), sd (Sindhi), si
(Sinhala), sk (Slovak), sl (Slovenian), sn
(Shona), so (Somali), sq (Albanian), sr
(Serbian), su (Sundanese), sv (Swedish), sw
(Swahili), ta (Tamil), te (Telugu), tg (Tajik),
th (Thai), tk (Turkmen), tl (Tagalog), tr
(Turkish), tt (Tatar), uk (Ukrainian), ur
(Urdu), uz (Uzbek), vi (Vietnamese), yi
(Yiddish), yo (Yoruba), zh (Chinese). Leave
empty to detect language.
-p, --prompt <prompt> Initial prompt.
-w, --word-timestamps Generate word-level timestamps.
-e, --extract-speech Extract speech from audio before transcribing.
--identify-speakers Identify speakers in the audio. Cli option available since version 1.4.6.
--speaker-count <count> Number of speakers in the audio. Implies
--identify-speakers. Cli option available since version 1.4.6.
--speaker-diarizer <diarizer> Speaker diarizer algorithm. Allowed: msdd,
sortformer. Default: msdd. Implies
--identify-speakers. Cli option available since version 1.4.6.
--openai-token <token> OpenAI access token. Use only when
--model-type is openaiapi. Defaults to your
previously saved access token, if one exists.
-d, --output-directory <directory>
Output directory. Defaults to the directory of
the input file.
--srt Output result in an SRT file.
--vtt Output result in a VTT file.
--txt Output result in a TXT file.
--hide-gui Hide the main application window.
-h, --help Displays help on commandline options.
--help-all Displays help including Qt specific options.
-v, --version Displays version information.
Arguments:
files or urls Input file paths or urls.
Examples:
# Transcribe a single file and save the transcript as a TXT file next to it
buzz add --txt interview.mp3
# Transcribe several files at once, they will be processed one after another.
# Support for multiple input files available since version 1.4.6
buzz add --txt lecture-1.mp3 lecture-2.mp3 lecture-3.mp3
# Transcribe a whole folder of recordings into a separate output folder
buzz add --srt --output-directory ./subtitles recordings/*.mp4
# Translate French audio to English with the OpenAI Whisper API
buzz add --task translate --language fr --model-type openaiapi meeting-fr.mp3
# Transcribe a video with the Whisper.cpp "small" model, exporting SRT and VTT subtitles
buzz add --model-type whispercpp --model-size small --srt --vtt presentation.mp4
# Transcribe an interview and label each speaker in the transcript.
# Speaker identification options available since version 1.4.6
buzz add --txt --identify-speakers interview.mp3
# Identify speakers when the number of speakers is known (implies --identify-speakers)
buzz add --srt --speaker-count 3 panel-discussion.mp4
# Identify speakers using the Sortformer diarizer (implies --identify-speakers)
buzz add --txt --speaker-diarizer sortformer podcast.mp3
# Transcribe a YouTube video without opening the app window
buzz add --txt --hide-gui https://www.youtube.com/watch?v=dQw4w9WgXcQ