MacWhisper CLI: installera mw, transkribera från Terminal och alla flaggor
Av Ryleigh Newman · Publicerad
MacWhisper levereras med ett kommandoradsverktyg som heter mw. Det styr appen från Terminal: du transkriberar filer och hela mappar, identifierar talare, skriver undertexter eller JSON och listar eller byter modeller. Verktyget pratar med den körande MacWhisper-appen över en lokal socket, så det använder de motorer, modeller och inställningar du redan har, och det startar appen om den inte är öppen.
Jag har gjort YapToText, en annan Mac-app för diktering och filtranskribering, så ha det i åtanke när du läser vad jag skriver om MacWhisper. Varje uppgift om MacWhisper här kommer från dess hjälpartikel MacWhisper Command-Line Tool, läst den 10 oktober 2026.
Gratis att hämta. Inget konto och inga låsta funktioner, för macOS 14 eller senare på en Mac med Apple-chip. Källkod på GitHub.
Den här guiden på andra språk: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Installera mw
- Öppna MacWhisper, sedan Settings (inställningar) och därefter Advanced.
- Klicka på Install under Command-Line Tool.
- Skriv ditt Mac-lösenord om macOS frågar. Det behövs för att skriva till /usr/local/bin.
- Öppna ett nytt Terminal-fönster och kör mw version.
Verktyget hamnar i /usr/local/bin/mw, och inställningspanelen visar en grön bock när det är klart. Om mw version skriver ut ett versionsnummer fungerar det. Vill du ta bort det går du tillbaka till samma panel och klickar på Uninstall.
Transkribera en fil
mw transcribe ~/Desktop/meeting.m4a
mw transcribe meeting.m4a > transcript.txt
mw transcribe meeting.m4a -o transcript.txt
mw transcribe meeting.m4a | pbcopyDet här händer: Transkriptionen skrivs ut till standard output. En förloppsrad går till standard error, så en omdirigerad fil innehåller bara transkriptionen.
Som standard sparas inte en transkription från kommandoraden. Den skrivs ut och kastas, och den syns i MacWhispers historik bara om du lägger till --persist. Ctrl+C stoppar en körning. En befintlig utdatafil ersätts aldrig om du inte lägger till --overwrite.
Kommandona
Från MacWhispers hjälpartikel, läst den 10 oktober 2026. Lägg till --help efter ett kommando för att se dess alternativ.
| Kommando | Det här gör det |
|---|---|
| mw | En statusöversikt: om appen går att nå, vilken modell som är vald, vilka modeller som är hämtade och exempelkommandon |
| mw version | Skriver ut MacWhispers version. Praktiskt som test av anslutningen |
| mw models list | Listar dina installerade transkriptionsmodeller, med ett ID för var och en |
| mw models select | Byter aktiv modell, både i kommandoradsverktyget och i appen |
| mw transcribe | Transkriberar ljud- eller videofiler, eller hela mappar, och skriver ut texten |
Flaggor för mw transcribe
Från samma artikel. Ett språk som den valda modellen inte kan transkribera ger ett felmeddelande.
| Flagga | Det här gör den |
|---|---|
| --speakers, --no-speakers | Slår talaridentifiering på eller av för den här körningen. Är den på grupperas transkriptionen efter talare |
| --format | txt, som är standard, eller srt, vtt, json, csv, md, html eller avid |
| --style | transcript, subtitles eller segments, samma stilar som i appens exportpanel |
| --model | Använder en viss modell för den här körningen utan att ändra appens val |
| --language | En ISO-språkkod som en eller de, eller auto, eller multilingual |
| --output, -o | Skriver transkriptionen till en fil |
| --output-dir | Batchläge. Skriver en transkription per indatafil till en mapp |
| --recursive | Tar med undermappar när du anger en mapp |
| --stream | Skriver ut segmenten när de är klara. Bara lokala motorer |
| --persist | Sparar transkriptionen i MacWhispers historik |
| --timestamps, --milliseconds, --group, --max-chars-per-line, --fps | Finjusterar layouten |
Format, och vilka som kräver Pro
Från samma artikel. På sidan om MacWhispers pris står vad Pro kostar.
| Format | Det här får du | Licens |
|---|---|---|
| txt | Ren text | Alla |
| srt | SubRip-undertexter | Alla |
| vtt | WebVTT-undertexter | Alla |
| csv | Rader med start, slut och transkription, plus talare när den har identifierats | Alla |
| json | Tidsstämplar i millisekunder, talare per segment och tider för varje ord | Pro |
| md | Markdown med tidsstämplade block och talarrubriker | Pro |
| html | Ett fristående HTML-dokument | Pro |
| avid | Avid-undertext med SMPTE-tidskoder | Pro |
Hela mappar
mw transcribe ~/Recordings --recursive --output-dir ~/Transcripts
mw transcribe ~/Videos --output-dir ~/Subs --format srt
mw transcribe interview.m4a --speakers -o interview.txtDet här händer: Varje indatafil får en egen fil som är döpt efter den, och mappstrukturen speglas. En fil som misslyckas rapporteras och hoppas över, och körningen fortsätter.
Talaridentifiering kräver en modell som stöder den. Sidan om talarigenkänning tar upp den delen av appen.
När det inte fungerar
- mw: command not found. Öppna ett nytt Terminal-fönster, eller lägg till /usr/local/bin i din PATH.
- Det hänger sig. Avsluta och öppna MacWhisper igen och prova sedan mw version.
- Ett modell-ID känns inte igen. Kör mw models list för att se de exakta ID:na och hämta modellen i appen först.
- Ett Pro-fel på ett format. json, md, html och avid kräver en Pro-licens.
- Ett sandbox-fel. Ett program i en sandbox, bland annat vissa AI-kodverktyg, kan vara blockerat från MacWhispers socket. Kör mw direkt i Terminal.
Felsökningssidan för MacWhisper tar upp själva appen.
Gratis vägar från Terminal
YapToText har inget kommandoradsverktyg. Appen transkriberar en fil som du släpper på den, en i taget, till ren text, gratis. Vill du ha Terminal och inte betala för något är whisper.cpp öppen källkod och den motor som YapToText bygger på. Guiden till lokal Whisper har kommandona, och sidan om transkriptionsprogram med öppen källkod jämför fyra gratisverktyg.
Gratis att hämta. Inget konto och inga låsta funktioner, för macOS 14 eller senare på en Mac med Apple-chip. Källkod på GitHub.
Kort sammanfattning
- Installera. Settings, Advanced, Command-Line Tool, Install.
- Kör. mw transcribe, sedan en fil eller en mapp.
- Gratisformat. txt, srt, vtt och csv.
- Pro-format. json, md, html och avid.
- Historik. Inget sparas om du inte lägger till --persist.
Om MacWhisper ändrar verktyget och den här sidan inte hänger med kan du öppna ett issue på GitHub. Jag läser alla.
Gratis att hämta. Inget konto och inga låsta funktioner, för macOS 14 eller senare på en Mac med Apple-chip. Källkod på GitHub.
Guider
Fler guider, på engelska
Källor
- https://docs.macwhisper.com/article/57-macwhisper-command-line-tool (kontrollerad 2026-10-10)
- https://github.com/ryleighnewman/YapToText (kontrollerad 2026-10-10)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (kontrollerad 2026-10-10)
Frågor
Har MacWhisper ett kommandoradsverktyg?
Ja. Det heter mw och du installerar det från MacWhispers Settings, under Advanced, Command-Line Tool.
Hur transkriberar jag en fil med MacWhisper från Terminal?
Kör mw transcribe följt av filens sökväg. Transkriptionen skrivs ut till standard output, eller till en fil med -o.
Är MacWhisper CLI gratis?
Enligt hjälpartikeln är utdata i txt, srt, vtt och csv tillgängligt för alla, medan json, md, html och avid kräver en Pro-licens.
Kan MacWhisper CLI transkribera en hel mapp?
Ja. Ange en mapp till mw transcribe, lägg till --recursive för undermappar och --output-dir för att skriva en transkription per fil.
Måste MacWhisper vara öppet för att mw ska fungera?
Verktyget pratar med den körande appen och startar MacWhisper automatiskt om den inte är öppen.