MacWhisper CLI: installer mw, transkriber fra Terminal og alle flaggene
Av Ryleigh Newman · Publisert
MacWhisper kommer med et kommandolinjeverktøy som heter mw. Det styrer appen fra Terminal: du transkriberer filer og hele mapper, finner talerne, skriver undertekster eller JSON, og lister opp eller bytter modeller. Det snakker med den kjørende MacWhisper-appen over en lokal socket, så det bruker motorene, modellene og innstillingene du allerede har satt opp, og det starter appen hvis den ikke er åpen.
Jeg utvikler YapToText, en annen Mac-app for diktering og filtranskripsjon, så les det jeg skriver om MacWhisper med det i bakhodet. Alle fakta om MacWhisper her kommer fra hjelpeartikkelen MacWhisper Command-Line Tool, lest 10. oktober 2026.
Gratis å laste ned. Ingen konto og ingen låste funksjoner, for macOS 14 eller nyere på en Mac med Apple-chip. Kildekode på GitHub.
Denne veiledningen på andre språk: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Installer mw
- Åpne MacWhisper, deretter Settings (innstillinger), deretter Advanced (avansert).
- Klikk på Install (installer) under Command-Line Tool (kommandolinjeverktøy).
- Skriv inn Mac-passordet ditt hvis macOS spør. Det trengs for å skrive til /usr/local/bin.
- Åpne et nytt Terminal-vindu og kjør mw version.
Verktøyet havner i /usr/local/bin/mw, og innstillingsruten viser en grønn hake når det er ferdig. Hvis mw version skriver ut et versjonsnummer, virker det. For å fjerne det går du tilbake til samme rute og klikker på Uninstall (avinstaller).
Transkriber en fil
mw transcribe ~/Desktop/meeting.m4a
mw transcribe meeting.m4a > transcript.txt
mw transcribe meeting.m4a -o transcript.txt
mw transcribe meeting.m4a | pbcopyDette skjer: Transkripsjonen skrives til standard utdata. En fremdriftslinje går til standard feilutdata, så en omdirigert fil inneholder bare transkripsjonen.
Som standard blir en transkripsjon fra kommandolinjen ikke lagret. Den skrives ut og forkastes, og vises i historikken til MacWhisper bare hvis du legger til --persist. Ctrl+C stopper en kjøring. En eksisterende utdatafil blir aldri erstattet med mindre du legger til --overwrite.
Kommandoene
Fra hjelpeartikkelen til MacWhisper, lest 10. oktober 2026. Legg til --help på en kommando for å se valgene den har.
| Kommando | Hva den gjør |
|---|---|
| mw | En statusoversikt: om appen kan nås, valgt modell, nedlastede modeller og eksempelkommandoer |
| mw version | Skriver ut MacWhisper-versjonen. Nyttig som test av forbindelsen |
| mw models list | Lister opp de installerte transkripsjonsmodellene dine, med en ID for hver |
| mw models select | Bytter aktiv modell, i kommandolinjeverktøyet og i appen |
| mw transcribe | Transkriberer lyd- eller videofiler, eller hele mapper, og skriver ut teksten |
Flagg for mw transcribe
Fra samme artikkel. Et språk som den valgte modellen ikke kan transkribere, gir en feilmelding.
| Flagg | Hva det gjør |
|---|---|
| --speakers, --no-speakers | Slår talergjenkjenning på eller av for denne kjøringen. Når den er på, grupperes transkripsjonen etter taler |
| --format | txt, som er standard, eller srt, vtt, json, csv, md, html eller avid |
| --style | transcript, subtitles eller segments, de samme stilene som i eksportpanelet i appen |
| --model | Bruker én modell for denne kjøringen uten å endre valget i appen |
| --language | En ISO-kode som en eller de, eller auto, eller multilingual |
| --output, -o | Skriver transkripsjonen til en fil |
| --output-dir | Batchmodus. Skriver én transkripsjon per inndata til en mappe |
| --recursive | Tar med undermapper når du oppgir en mappe |
| --stream | Skriver ut segmenter etter hvert som de er ferdige. Bare lokale motorer |
| --persist | Beholder transkripsjonen i historikken til MacWhisper |
| --timestamps, --milliseconds, --group, --max-chars-per-line, --fps | Finjusterer oppsettet |
Formater, og hvilke som krever Pro
Fra samme artikkel. Prissiden for MacWhisper forteller hva Pro koster.
| Format | Hva du får | Lisens |
|---|---|---|
| txt | Ren tekst | Alle |
| srt | SubRip-undertekster | Alle |
| vtt | WebVTT-undertekster | Alle |
| csv | Rader med start, slutt og transkripsjon, pluss taler når den er funnet | Alle |
| json | Tidsstempler i millisekunder, talere per segment og ordtider | Pro |
| md | Markdown med tidsstemplede blokker og overskrifter for talerne | Pro |
| html | Et frittstående HTML-dokument | Pro |
| avid | Avid-undertekster som tekst med SMPTE-tidskoder | Pro |
Hele mapper
mw transcribe ~/Recordings --recursive --output-dir ~/Transcripts
mw transcribe ~/Videos --output-dir ~/Subs --format srt
mw transcribe interview.m4a --speakers -o interview.txtDette skjer: Hver inndata får sin egen fil, oppkalt etter seg selv, og mappestrukturen speiles. En fil som feiler, blir rapportert og hoppet over, og kjøringen fortsetter.
Talergjenkjenning krever en modell som støtter det. Siden om talergjenkjenning tar for seg den siden av appen.
Når det ikke virker
- mw: command not found. Åpne et nytt Terminal-vindu, eller legg /usr/local/bin til i PATH.
- Det henger seg. Avslutt og åpne MacWhisper på nytt, og prøv deretter mw version.
- En modell-ID blir ikke gjenkjent. Kjør mw models list for å se de nøyaktige ID-ene, og last ned modellen i appen først.
- En Pro-feil på et format. json, md, html og avid krever en Pro-lisens.
- En sandbox-feil. Et program i sandbox, blant annet enkelte AI-kodeverktøy, kan bli blokkert fra socketen til MacWhisper. Kjør mw direkte i Terminal.
Feilsøkingssiden for MacWhisper tar for seg selve appen.
Gratis veier fra Terminal
YapToText har ikke noe kommandolinjeverktøy. Den transkriberer én fil om gangen som du slipper på den, til ren tekst, gratis. Vil du bruke Terminal og ikke kjøpe noe, er whisper.cpp åpen kildekode og motoren YapToText er bygget på. Guiden til lokal Whisper har kommandoene, og siden om transkripsjonsprogramvare med åpen kildekode sammenligner fire gratisverktøy.
Gratis å laste ned. Ingen konto og ingen låste funksjoner, for macOS 14 eller nyere på en Mac med Apple-chip. Kildekode på GitHub.
Kortversjonen
- Installer. Settings, Advanced, Command-Line Tool, Install.
- Kjør. mw transcribe, deretter en fil eller en mappe.
- Gratis formater. txt, srt, vtt og csv.
- Pro-formater. json, md, html og avid.
- Historikk. Ingenting blir lagret med mindre du legger til --persist.
Hvis MacWhisper endrer verktøyet og denne siden henger etter, kan du opprette et issue på GitHub. Jeg leser alle.
Gratis å laste ned. Ingen konto og ingen låste funksjoner, for macOS 14 eller nyere på en Mac med Apple-chip. Kildekode på GitHub.
Veiledninger
Flere veiledninger, på engelsk
Kilder
- https://docs.macwhisper.com/article/57-macwhisper-command-line-tool (kontrollert 10.10.2026)
- https://github.com/ryleighnewman/YapToText (kontrollert 10.10.2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (kontrollert 10.10.2026)
Spørsmål
Har MacWhisper et kommandolinjeverktøy?
Ja. Det heter mw, og du installerer det fra Settings i MacWhisper, under Advanced, Command-Line Tool.
Hvordan transkriberer jeg en fil med MacWhisper fra Terminal?
Kjør mw transcribe etterfulgt av filstien. Transkripsjonen skrives til standard utdata, eller til en fil med -o.
Er MacWhisper CLI gratis?
Hjelpeartikkelen sier at utdata i txt, srt, vtt og csv er tilgjengelig for alle, og at json, md, html og avid krever en Pro-lisens.
Kan MacWhisper CLI transkribere en hel mappe?
Ja. Oppgi en mappe til mw transcribe, legg til --recursive for undermapper og --output-dir for å skrive én transkripsjon per fil.
Må MacWhisper være åpen for at mw skal virke?
Det snakker med den kjørende appen, og starter MacWhisper automatisk hvis den ikke er åpen.