MacWhisper CLI: installer mw, transskriber fra Terminal og se alle flag
Af Ryleigh Newman · Udgivet
MacWhisper leveres med et kommandolinjeværktøj, der hedder mw. Det styrer appen fra Terminal: Du transskriberer filer og hele mapper, finder talere, skriver undertekster eller JSON og viser eller skifter modeller. Det taler med den kørende MacWhisper-app over en lokal socket, så det bruger de motorer, modeller og indstillinger, du allerede har sat op, og det starter appen, hvis den ikke er åben.
Jeg har udviklet YapToText, en anden Mac-app til diktering og filtransskription, så læs det, jeg skriver om MacWhisper, med det i tankerne. Alle fakta om MacWhisper her kommer fra hjælpeartiklen MacWhisper Command-Line Tool, læst den 10. oktober 2026.
Gratis at hente. Ingen konto og ingen låste funktioner, til macOS 14 eller nyere på en Mac med Apple-chip. Kildekode på GitHub.
Denne vejledning på andre sprog: English, العربية, Čeština, Deutsch, Ελληνικά, 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, 简体中文, 繁體中文
Installer mw
- Åbn MacWhisper, derefter Settings (indstillinger), derefter Advanced (avanceret).
- Klik på Install (installer) under Command-Line Tool (kommandolinjeværktøj).
- Skriv din Mac-adgangskode, hvis macOS spørger. Den skal bruges for at skrive til /usr/local/bin.
- Åbn et nyt Terminal-vindue og kør mw version.
Værktøjet havner i /usr/local/bin/mw, og indstillingspanelet viser et grønt flueben, når det er færdigt. Hvis mw version skriver et versionsnummer, virker det. Vil du fjerne det igen, går du tilbage til det samme panel og klikker på Uninstall (afinstaller).
Transskriber 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 sker der: Transskriptionen skrives til standardoutput. En statuslinje går til standardfejl, så en omdirigeret fil kun indeholder transskriptionen.
Som standard gemmes en transskription fra kommandolinjen ikke. Den skrives ud og kasseres, og den vises kun i MacWhispers historik, hvis du tilføjer --persist. Med Ctrl+C stopper du en kørsel. En eksisterende outputfil bliver aldrig erstattet, medmindre du tilføjer --overwrite.
Kommandoerne
Fra MacWhispers hjælpeartikel, læst den 10. oktober 2026. Tilføj --help til en kommando for at se dens muligheder.
| Kommando | Det gør den |
|---|---|
| mw | En statusoversigt: om appen kan nås, den valgte model, de hentede modeller og eksempelkommandoer |
| mw version | Skriver MacWhispers version. Nyttig som test af forbindelsen |
| mw models list | Viser dine installerede transskriptionsmodeller, med et ID til hver |
| mw models select | Skifter den aktive model, både i kommandolinjeværktøjet og i appen |
| mw transcribe | Transskriberer lyd- eller videofiler eller hele mapper og skriver teksten ud |
Flag til mw transcribe
Fra den samme artikel. Et sprog, som den valgte model ikke kan transskribere, giver en fejl.
| Flag | Det gør det |
|---|---|
| --speakers, --no-speakers | Slår talergenkendelse til eller fra for denne kørsel. Når den er slået til, grupperes transskriptionen efter taler |
| --format | txt, som er standard, eller srt, vtt, json, csv, md, html eller avid |
| --style | transcript, subtitles eller segments, de samme typer som i appens eksportpanel |
| --model | Bruger én bestemt model til denne kørsel uden at ændre appens valg |
| --language | En ISO-kode som en eller de, eller auto, eller multilingual |
| --output, -o | Skriver transskriptionen til en fil |
| --output-dir | Batchtilstand. Skriver én transskription pr. input til en mappe |
| --recursive | Tager undermapper med, når du angiver en mappe |
| --stream | Skriver segmenter ud, efterhånden som de bliver færdige. Kun med lokale motorer |
| --persist | Gemmer transskriptionen i MacWhispers historik |
| --timestamps, --milliseconds, --group, --max-chars-per-line, --fps | Finjusterer layoutet |
Formater, og hvilke der kræver Pro
Fra den samme artikel. Siden om MacWhispers priser fortæller, hvad Pro koster.
| Format | Det får du | Licens |
|---|---|---|
| txt | Ren tekst | Alle |
| srt | SubRip-undertekster | Alle |
| vtt | WebVTT-undertekster | Alle |
| csv | Rækker med start, slut og transskription, plus taler, når den er fundet | Alle |
| json | Tidsstempler i millisekunder, talere pr. segment og tider for hvert ord | Pro |
| md | Markdown med blokke med tidsstempler og overskrifter med talere | Pro |
| html | Et selvstændigt 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.txtDet sker der: Hvert input får sin egen fil, opkaldt efter det, og mappestrukturen bliver gentaget. En fil, der fejler, bliver meldt og sprunget over, og kørslen fortsætter.
Talergenkendelse kræver en model, der understøtter den. Siden om talergenkendelse handler om den side af appen.
Når det ikke virker
- mw: command not found. Åbn et nyt Terminal-vindue, eller føj /usr/local/bin til din PATH.
- Den hænger. Afslut MacWhisper og åbn den igen, og prøv så mw version.
- Et model-ID bliver ikke genkendt. Kør mw models list for at se de præcise ID'er, og hent modellen i appen først.
- En Pro-fejl på et format. json, md, html og avid kræver en Pro-licens.
- En sandbox-fejl. Et program i en sandbox, blandt andet nogle AI-kodeværktøjer, kan være spærret fra MacWhispers socket. Kør mw direkte i Terminal.
Siden om fejlfinding i MacWhisper handler om selve appen.
Gratis veje fra Terminal
YapToText har intet kommandolinjeværktøj. Den transskriberer en fil, du slipper på den, én ad gangen, til ren tekst, gratis. Vil du bruge Terminal og ikke købe noget, er whisper.cpp open source og den motor, YapToText er bygget på. Guiden til lokal Whisper har kommandoerne, og siden om open source-transskription sammenligner fire gratis værktøjer.
Gratis at hente. Ingen konto og ingen låste funktioner, til macOS 14 eller nyere på en Mac med Apple-chip. Kildekode på GitHub.
Kort fortalt
- Installer. Settings, Advanced, Command-Line Tool, Install.
- Kør. mw transcribe, derefter en fil eller en mappe.
- Gratis formater. txt, srt, vtt og csv.
- Pro-formater. json, md, html og avid.
- Historik. Intet bliver gemt, medmindre du tilføjer --persist.
Hvis MacWhisper ændrer værktøjet, og siden bagefter hænger i, så opret et issue på GitHub. Jeg læser dem alle.
Gratis at hente. Ingen konto og ingen låste funktioner, til macOS 14 eller nyere på en Mac med Apple-chip. Kildekode på GitHub.
Vejledninger
Flere vejledninger, på engelsk
Kilder
- https://docs.macwhisper.com/article/57-macwhisper-command-line-tool (kontrolleret 10.10.2026)
- https://github.com/ryleighnewman/YapToText (kontrolleret 10.10.2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (kontrolleret 10.10.2026)
Spørgsmål
Har MacWhisper et kommandolinjeværktøj?
Ja. Det hedder mw, og du installerer det fra MacWhispers Settings under Advanced, Command-Line Tool.
Hvordan transskriberer jeg en fil med MacWhisper fra Terminal?
Kør mw transcribe efterfulgt af filens sti. Transskriptionen skrives til standardoutput, eller til en fil med -o.
Er MacWhisper CLI gratis?
Ifølge hjælpeartiklen er output i txt, srt, vtt og csv tilgængeligt for alle, og json, md, html og avid kræver en Pro-licens.
Kan MacWhisper CLI transskribere en hel mappe?
Ja. Giv mw transcribe en mappe, tilføj --recursive for undermapper og --output-dir for at skrive én transskription pr. fil.
Skal MacWhisper være åben, for at mw virker?
Det taler med den kørende app og starter MacWhisper automatisk, hvis den ikke er åben.