Die MacWhisper CLI: mw installieren, im Terminal transkribieren und jede Option
Von Ryleigh Newman · Veröffentlicht am
MacWhisper bringt ein Kommandozeilenprogramm namens mw mit. Es steuert die App vom Terminal aus: Du transkribierst Dateien und ganze Ordner, erkennst Sprecher, schreibst Untertitel oder JSON und listest Modelle auf oder wechselst sie. Es spricht über einen lokalen Socket mit der laufenden MacWhisper-App, nutzt also die Engines, Modelle und Einstellungen, die du schon eingerichtet hast, und startet die App, wenn sie nicht geöffnet ist.
Ich entwickle YapToText, eine andere Mac-App für Diktat und Dateitranskription. Lies also alles, was ich über MacWhisper sage, mit diesem Wissen. Jede Aussage über MacWhisper stammt hier aus dem Hilfeartikel MacWhisper Command-Line Tool, gelesen am 10. Oktober 2026.
Kostenlos laden. Kein Konto, nichts gesperrt, für macOS 14 oder neuer auf einem Mac mit Apple Chip. Quellcode auf GitHub.
Diese Anleitung in anderen Sprachen: English, العربية, Čeština, Dansk, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
mw installieren
- Öffne MacWhisper, dann Settings (Einstellungen), dann Advanced (Erweitert).
- Klicke unter Command-Line Tool (Kommandozeilenprogramm) auf Install (Installieren).
- Gib dein Mac-Passwort ein, wenn macOS danach fragt. Es wird gebraucht, um nach /usr/local/bin zu schreiben.
- Öffne ein neues Terminal-Fenster und führe mw version aus.
Das Programm landet unter /usr/local/bin/mw, und im Einstellungsbereich erscheint ein grünes Häkchen, sobald es fertig ist. Wenn mw version eine Versionsnummer ausgibt, funktioniert es. Zum Entfernen gehst du zurück in denselben Bereich und klickst auf Uninstall (Deinstallieren).
Eine Datei transkribieren
mw transcribe ~/Desktop/meeting.m4a
mw transcribe meeting.m4a > transcript.txt
mw transcribe meeting.m4a -o transcript.txt
mw transcribe meeting.m4a | pbcopyWas passiert: Das Transkript wird in der Standardausgabe ausgegeben. Eine Fortschrittszeile geht an die Standardfehlerausgabe, deshalb enthält eine umgeleitete Datei nur das Transkript.
Standardmäßig wird eine Transkription über die Kommandozeile nicht gespeichert. Sie wird ausgegeben und verworfen und erscheint im Verlauf von MacWhisper nur, wenn du --persist angibst. Mit Ctrl+C brichst du einen Lauf ab. Eine vorhandene Ausgabedatei wird nie ersetzt, solange du nicht --overwrite angibst.
Die Befehle
Aus dem Hilfeartikel von MacWhisper, gelesen am 10. Oktober 2026. Mit --help bei jedem Befehl siehst du seine Optionen.
| Befehl | Was er tut |
|---|---|
| mw | Eine Statusübersicht: ob die App erreichbar ist, das gewählte Modell, die heruntergeladenen Modelle und Beispielbefehle |
| mw version | Gibt die MacWhisper-Version aus. Nützlich als Verbindungstest |
| mw models list | Listet deine installierten Transkriptionsmodelle auf, mit einer ID für jedes |
| mw models select | Ändert das aktive Modell, im Kommandozeilenprogramm und in der App |
| mw transcribe | Transkribiert Audio- oder Videodateien oder ganze Ordner und gibt den Text aus |
Optionen für mw transcribe
Aus demselben Artikel. Eine Sprache, die das gewählte Modell nicht transkribieren kann, führt zu einem Fehler.
| Option | Was sie tut |
|---|---|
| --speakers, --no-speakers | Schaltet die Sprechererkennung für diesen Lauf ein oder aus. Ist sie an, wird das Transkript nach Sprechern gruppiert |
| --format | txt, der Standard, oder srt, vtt, json, csv, md, html oder avid |
| --style | transcript, subtitles oder segments, dieselben Stile wie im Bereich Export der App |
| --model | Nutzt für diesen Lauf ein bestimmtes Modell, ohne die Auswahl der App zu ändern |
| --language | Ein ISO-Code wie en oder de, oder auto, oder multilingual |
| --output, -o | Schreibt das Transkript in eine Datei |
| --output-dir | Stapelmodus. Schreibt ein Transkript pro Eingabe in einen Ordner |
| --recursive | Schließt Unterordner ein, wenn du einen Ordner angibst |
| --stream | Gibt Segmente aus, sobald sie fertig sind. Nur mit lokalen Engines |
| --persist | Behält die Transkription im Verlauf von MacWhisper |
| --timestamps, --milliseconds, --group, --max-chars-per-line, --fps | Feinabstimmung des Layouts |
Formate und welche Pro brauchen
Aus demselben Artikel. Die Preisseite von MacWhisper sagt, was Pro kostet.
| Format | Was du bekommst | Lizenz |
|---|---|---|
| txt | Nur Text | Alle |
| srt | SubRip-Untertitel | Alle |
| vtt | WebVTT-Untertitel | Alle |
| csv | Zeilen mit Start, Ende und Transkript, dazu der Sprecher, wenn er erkannt wurde | Alle |
| json | Zeitstempel in Millisekunden, Sprecher pro Segment und Wortzeiten | Pro |
| md | Markdown mit Blöcken mit Zeitstempel und Überschriften für die Sprecher | Pro |
| html | Ein eigenständiges HTML-Dokument | Pro |
| avid | Avid-Untertiteltext mit SMPTE-Timecodes | Pro |
Ganze Ordner
mw transcribe ~/Recordings --recursive --output-dir ~/Transcripts
mw transcribe ~/Videos --output-dir ~/Subs --format srt
mw transcribe interview.m4a --speakers -o interview.txtWas passiert: Jede Eingabe bekommt eine eigene Datei, die nach ihr benannt ist, und die Ordnerstruktur wird gespiegelt. Eine Datei, bei der etwas schiefgeht, wird gemeldet und übersprungen, und der Lauf geht weiter.
Die Sprechererkennung braucht ein Modell, das sie unterstützt. Die Seite zur Sprechererkennung behandelt diese Seite der App.
Wenn es nicht funktioniert
- mw: command not found. Öffne ein neues Terminal-Fenster oder füge /usr/local/bin zu deinem PATH hinzu.
- Es hängt. Beende MacWhisper und öffne es erneut, dann probiere mw version.
- Eine Modell-ID wird nicht erkannt. Führe mw models list aus, um die genauen IDs zu sehen, und lade das Modell zuerst in der App herunter.
- Ein Pro-Fehler bei einem Format. json, md, html und avid brauchen eine Pro-Lizenz.
- Ein Sandbox-Fehler. Ein Programm in einer Sandbox, auch manche KI-Coding-Werkzeuge, kann vom Socket von MacWhisper ausgesperrt sein. Führe mw direkt im Terminal aus.
Die Seite zur Fehlersuche bei MacWhisper behandelt die App selbst.
Kostenlose Wege im Terminal
YapToText hat kein Kommandozeilenprogramm. Es transkribiert eine Datei, die du darauf ziehst, jeweils eine auf einmal, kostenlos in reinen Text. Wenn du das Terminal willst und nichts kaufen möchtest: whisper.cpp ist Open Source und die Engine, auf der YapToText aufbaut. Der Leitfaden zu lokalem Whisper hat die Befehle, und die Seite zu Open-Source-Transkription vergleicht vier kostenlose Werkzeuge.
Kostenlos laden. Kein Konto, nichts gesperrt, für macOS 14 oder neuer auf einem Mac mit Apple Chip. Quellcode auf GitHub.
Kurz gesagt
- Installieren. Settings, Advanced, Command-Line Tool, Install.
- Ausführen. mw transcribe, dann eine Datei oder ein Ordner.
- Kostenlose Formate. txt, srt, vtt und csv.
- Pro-Formate. json, md, html und avid.
- Verlauf. Nichts wird gespeichert, solange du nicht --persist angibst.
Wenn MacWhisper das Programm ändert und diese Seite nicht mehr stimmt, eröffne ein Issue auf GitHub. Ich lese jedes.
Kostenlos laden. Kein Konto, nichts gesperrt, für macOS 14 oder neuer auf einem Mac mit Apple Chip. Quellcode auf GitHub.
Anleitungen
Weitere Anleitungen, auf Englisch
Quellen
- https://docs.macwhisper.com/article/57-macwhisper-command-line-tool (geprüft am 10. Oktober 2026)
- https://github.com/ryleighnewman/YapToText (geprüft am 10. Oktober 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (geprüft am 10. Oktober 2026)
Fragen
Hat MacWhisper ein Kommandozeilenprogramm?
Ja. Es heißt mw, und du installierst es in den Einstellungen von MacWhisper unter Advanced, Command-Line Tool.
Wie transkribiere ich mit MacWhisper im Terminal eine Datei?
Führe mw transcribe aus, gefolgt vom Dateipfad. Das Transkript wird in der Standardausgabe ausgegeben oder mit -o in eine Datei geschrieben.
Ist die MacWhisper CLI kostenlos?
Laut dem Hilfeartikel stehen die Ausgaben txt, srt, vtt und csv allen offen, während json, md, html und avid eine Pro-Lizenz brauchen.
Kann die MacWhisper CLI einen ganzen Ordner transkribieren?
Ja. Gib mw transcribe einen Ordner an, füge --recursive für Unterordner hinzu und --output-dir, um pro Datei ein Transkript zu schreiben.
Muss MacWhisper für mw geöffnet sein?
Es spricht mit der laufenden App und startet MacWhisper automatisch, wenn es nicht geöffnet ist.