Transcribe audio or video to text locally — on the Apple GPU with mlx-whisper large-v3, or faster-whisper on CPU/CUDA — with the language decided per stretch of speech, .srt subtitles, word timings for editing, and optional speaker labels. Nothing is uploaded. Use when user says "расшифруй", "транскрибируй", "transcribe this", "make a transcript", "субтитры из видео", "что там говорят в записи", or hands a recording, a call, a voice memo or a folder of clips that needs its speech as text. Do ...
Installs into .claude/skills of the current project.
Sponsors
SSkills DirectorySkills Directory
Know which skills are safe — weekly.
SSkills DirectorySkills Directory
Is that skill safe to install?
Are you the author of Transcribe?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/fortunto2-transcribe)
---
name: solo-transcribe
description: Transcribe audio or video to text locally — on the Apple GPU with mlx-whisper large-v3, or faster-whisper on CPU/CUDA — with the language decided per stretch of speech, .srt subtitles, word timings for editing, and optional speaker labels. Nothing is uploaded. Use when user says "расшифруй", "транскрибируй", "transcribe this", "make a transcript", "субтитры из видео", "что там говорят в записи", or hands a recording, a call, a voice memo or a folder of clips that needs its speech as text. Do NOT use for listening to a live room (use /supervox) or for cutting the footage itself (use /video-edit).
license: MIT
metadata:
author: fortunto2
version: "1.0.1"
openclaw:
emoji: "🎙️"
---
# transcribe — local speech to text, GPU first
Any ffmpeg-decodable file becomes `<name>.txt` (`[MM:SS] (lang) text`), `<name>.srt`, and on request
`<name>.words.json` with per-word timings, the input a video edit needs. Audio never leaves the
machine; the only network step is a one-time model download.
## Pick the engine
| Machine | Script | Why |
|---|---|---|
| Apple Silicon | `scripts/transcribe_mlx.py` | large-v3 on the GPU. Measured: 2 min of a noisy prize announcement in 16 s, where `medium` on CPU returned fragments; a 38-min talk in 8.7 min (4x realtime) |
| NVIDIA / Linux, or speaker labels needed | `scripts/transcribe.py` | faster-whisper (CTranslate2): CUDA yes, **Metal no**, so on a Mac it is CPU-only however fast the Mac |
```bash
uv run scripts/transcribe_mlx.py rec.m4a # → rec.txt, rec.srt
uv run scripts/transcribe_mlx.py clip.mp4 --words # + rec.words.json for editing
uv run scripts/transcribe_mlx.py call.m4a --languages en ru # languages that can occur
uv run scripts/transcribe.py rec.m4a --model large-v3 # CPU/CUDA path
uv run scripts/transcribe.py call.m4a --multilingual # per-segment language on that path
uv run --with pyannote.audio scripts/transcribe.py talk.wav --diarize --speakers Alice Bob
```
Both scripts declare their dependencies in a PEP 723 header, so `uv run` needs no venv. Diarization
needs `HUGGINGFACE_TOKEN` with the pyannote model terms accepted; without it the transcript comes back
unlabelled, and the script says so.
Long files (10+ min): run in the background and wait for `✅ done`.
## Gotchas
- **Whisper picks one language from the first 30 s and applies it to the whole file.** A call that
opens in English and moves to Russian comes out as fluent, confident English, or the second
language simply vanishes (measured: a Russian+English file detected as `ru` returned only the
Russian words). `transcribe_mlx.py` splits on silences (Silero VAD) and detects per chunk; on the
CPU path pass `--multilingual`.
- **A chunk detected as a language not in `--languages`** (Russian read as Ukrainian, a laugh as
Welsh) is re-run in the first non-English listed language instead of keeping the guess.
- **Accented English is detected as the speaker's native language and comes back translated.** A
Russian speaker asking a question in English at a talk, with `--languages ru en`, returned a fluent
Russian sentence the speaker never said. For a recording known to be one language, force it
(`--languages en`) and keep the multi-language run only where the language really switches.
- **A quiet distant voice can vanish under the VAD.** At a panel filmed from the audience, a speaker
~9 dB below the person next to the camera (−31 vs −22.5 dB mean) lost two minutes of her answer:
the transcript jumps from 02:53 to 04:26 with no gap marker. Check long gaps in the timestamps; a
second recording (a laptop transcriber in the room) or a normalised re-run fills them.
- **Crowd noise hallucinates.** 25 minutes of a bar came back as `lang=fr` with 454 invented
sentences. Treat such a file as no speech; if one voice in it matters, re-run with the language
forced.
- **Unknown names become celebrities.** Keep a glossary per project (people, places, products) and
fix the transcript once, before anything quotes it.
- **Screen recordings on macOS often have no audio track.** `ffprobe` first.
- **Parakeet: check the version.** v2 (`parakeet-tdt-0.6b-v2`) is English-only and turns other
languages into confident English nonsense. v3 (`parakeet-tdt-0.6b-v3`) covers 25 European
languages, Russian among them, but not Bashkir or Tatar (keep Whisper for those). v3 runs wherever
ONNX Runtime does, CPU included: `onnx-asr` in Python (`onnx_asr.load_model("nemo-parakeet-tdt-0.6b-v3")`),
`parakeet-rs` in Rust (supervox). The scripts in this skill do not drive it yet.
## Finding recordings on a Mac
- Zoom: `~/Documents/Zoom/<date time …>/audioNNN.m4a` (folder name = start, file mtime ≈ end).
- Voice Memos: names and files are in
`~/Library/Group Containers/group.com.apple.VoiceMemos.shared/Recordings/CloudRecordings.db`
(`ZCLOUDRECORDING`: `ZCUSTOMLABEL`, `ZPATH`, `ZDATE` + 978307200 = unix start, `ZDURATION`).
- Long video on a slow card: pull only the audio, `ffmpeg -i in.mp4 -vn -c:a copy out.m4a`.
## Privacy
Write transcripts where the task lives, never into an unrelated repo. Personal recordings belong in
the user's own private store, not next to project code.