File Transcription

File Transcription

The File transcription page lets you import audio files, run them through the active transcription engine, queue many files at once, and have folders transcribed automatically. It can also export subtitles when the engine returns segment timing.

📸 Screenshot needed: The File transcription page with one completed transcription shown, the import/drop area visible, and the batch queue panel populated with a couple of files.

Importing and transcribing files

Bring an audio file into TypeWhisper by dragging and dropping it onto the File transcription page, then transcribe it with the active engine. The same transcription model selected on the Dictation page is used here, so whatever you have loaded for dictation also drives file transcription.

For formats beyond what the engine supports directly, TypeWhisper uses an ffmpeg-based importer to convert the audio before transcription. Install ffmpeg through your distribution if you need to import formats that are not handled directly.

📸 Screenshot needed: A file being dragged onto the File transcription drop area, mid-drop.

Batch file transcription queue

You can queue multiple files for transcription at once. The batch queue tracks per-file status so you can see which files are pending, in progress, completed, or errored as the queue works through them.

📸 Screenshot needed: The batch queue showing several files with mixed per-file statuses (pending, in progress, done).

Watch folders

Watch folders transcribe new audio automatically as files arrive. Each watch folder supports the following options.

Option	Description
Export format	Output format for the transcription: md, txt, srt, or vtt.
Language override	Optionally force a language for files in this folder instead of auto-detection.
Auto-start on launch	Begin watching this folder automatically when the app starts.
Delete source after export	Optionally remove the original audio file once its transcription has been exported.

📸 Screenshot needed: The watch folder configuration showing the export format selector, language override, auto-start toggle, and delete-source-after-export toggle.

Subtitle export (SRT and WebVTT)

When the active engine returns segment timing, you can export subtitles to SRT and WebVTT directly from the File transcription page. If the engine does not provide segment timing, subtitle export is not available for that transcription. See Transcription engines for which engines provide timing.

📸 Screenshot needed: The subtitle export controls (SRT / WebVTT) on the File transcription page after a transcription with segment timing.

Related pages

• Recorder — record longer WAV sessions and transcribe them after recording stops.
• Transcription engines — the engines that power file transcription.
• HTTP API — transcribe files programmatically, using the same ffmpeg-based importer.

---

Changelog

Date	Change
2026-06-17	Initial version.