Spokenly CLI (Command Line)

The spokenly CLI lets you transcribe audio and video files directly from your terminal. It connects to the Spokenly app running on your Mac and returns plain text, SRT, VTT, or Markdown output.

Install

Open Settings

Open Spokenly > General Settings, scroll to the bottom and click Install CLI.

Enter your password

macOS will ask for your password to create a symlink in /usr/local/bin/. This is a standard system directory for command-line tools. Spokenly does not gain any elevated privileges; the prompt is only for placing the shortcut there.

Use it in your terminal

Run spokenly transcribe <file> in any terminal. The installed executable is a small bash script that forwards your arguments to the locally running Spokenly app. All transcription happens inside the app itself.

Usage

spokenly transcribe <file...> [options]

Options

Flag	Description
`-f, --format <fmt>`	Output format: `text` (default), `srt`, `vtt`, `markdown`
`-s, --speakers`	Include speaker labels
`-h, --help`	Show help

Examples

Transcribe a meeting recording:

spokenly transcribe meeting.mp3

Transcribe with speaker labels in VTT format:

spokenly transcribe interview.mp3 --format vtt --speakers

Pipe output to clipboard:

spokenly transcribe meeting.mp3 | pbcopy

Transcribe multiple files:

spokenly transcribe part1.mp3 part2.mp3 --format markdown

Transcription Model

The CLI uses the model selected in the Transcribe File section of the app. If you have a local model like NVIDIA Parakeet installed, transcription runs entirely on your Mac. Otherwise, the file is sent to the Spokenly server for online transcription.

Requirements

Spokenly 2.18.13+ (macOS sideload version)
Spokenly must be running in the background

The CLI communicates with the Spokenly app's local server. If the app is not running, the command exits with an error.

Uninstall

Open Spokenly > Settings > General and click Uninstall CLI. This removes the command from /usr/local/bin.