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
Open Settings → Transcribe
Find Command, under Terminal.
- 2
Click Install
With Homebrew that is all. Without it, macOS asks for your password once.
- 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