Skip to content Black FridayUp to 76% off Vitals, Levers and SoundBar, until 5 December
Flit · The flit command

Transcribe audio from the Terminal with the flit command

The transcriber behind Flit’s Transcribe tab is also a command. Install it once and flit transcribe turns a recording into text in any Terminal window, which suits a folder of recordings or a script.

The Terminal section of Flit’s Transcribe tab: a Command row with an Install button, and the line flit transcribe meeting.m4a --srt under it

Install it from Settings

Open Settings → Transcribe and find Command under Terminal. Click Install. On a Mac with Homebrew that is all. On a Mac without it, macOS asks for your password once. Then open a new Terminal window, because a window that was already open does not see a new command. The line to type is shown under the button.

The command follows the app, so moving or updating Flit does not break it. Remove takes it away again.

Transcribe a file

Type flit transcribe and the name of a recording, such as flit transcribe meeting.m4a. The transcript is printed in the window, and the last line gives the speed and the word count.

The three formatting values are the levels the tab uses. Verbatim keeps every word. Clean removes hesitations and writes times and numbers properly. Polished runs the formatting model over each paragraph, which takes longer: in Flit’s tests with Cohere Transcribe, a two-hour recording took about three and a half minutes at Clean and about fifteen at Polished. The options:

  • --formatting takes verbatim, clean or polished
  • --out names a folder to write the transcript to as a text file
  • --srt and --vtt write subtitles to that folder as well
  • --md writes Markdown in place of the text file
  • --model and --language choose the voice model and the language of the recording

A fuller example

flit transcribe meeting.m4a --formatting clean --out ~/Transcripts --srt transcribes the file at the Clean level, writes the transcript to a Transcripts folder in your home folder, and puts an SRT subtitle file beside it.

flit help lists every option, and flit version says which Flit the command belongs to.

If the name flit is already taken

Another tool on your Mac may already answer to flit; a Python packaging tool of that name does. Nothing of yours is replaced. The command is installed as flit-app instead, and the row in Settings says so. If the Terminal reports that the command is not found, check that row and type the name it shows.

The same transcriber, on your Mac

The command is the same transcriber as the tab, so the recording is read on your Mac by the voice models that dictate, and nothing is uploaded. The file is read in pieces, so a long recording does not fill memory. The same limits apply as in the tab: a transcript is one flow of text, with no speaker labels yet.

The tab is the better place for one recording you want to read and export by hand. The command is for work you repeat.

How to use it

  1. 1

    Open Settings → Transcribe

    Find Command, under Terminal.

  2. 2

    Click Install

    With Homebrew that is all. Without it, macOS asks for your password once.

  3. 3

    Open a new Terminal window

    Type flit transcribe and the name of a recording.

The details

Command
flit, or flit-app when the name is taken
Usage
flit transcribe <file>
--formatting
verbatim, clean or polished
Output
--out <folder>, --md, --srt, --vtt
Model and language
--model, --language
Also
flit help, flit version
Since
Flit 1.5

Questions

The flit command is not found. What now?

Open a new Terminal window. If the row in Settings says flit-app, type that instead: another tool already had the name flit.

Does the command upload my recordings?

No. It is the same on-device transcriber as the app, and nothing leaves the Mac.

Can it write subtitle files?

Yes. Add --srt or --vtt along with --out, and the subtitles are written to that folder.

Do I need Homebrew to install it?

No. With Homebrew the install needs nothing more. Without it, macOS asks for your password once.

The same feature on the app's own site: flit.fyi/changelog/1.5

Stop typing what you could just say.