De MacWhisper CLI: mw installeren, vanuit Terminal transcriberen en alle opties
Door Ryleigh Newman · Gepubliceerd op
MacWhisper wordt geleverd met een opdrachtregelprogramma, mw. Daarmee bedien je de app vanuit Terminal: bestanden en hele mappen transcriberen, sprekers herkennen, ondertitels of JSON schrijven en modellen tonen of wisselen. Het programma praat via een lokale socket met de draaiende MacWhisper-app, dus het gebruikt de engines, modellen en instellingen die je al hebt ingesteld, en het start de app als die niet open staat.
Ik heb YapToText gemaakt, een andere Mac-app voor dicteren en het transcriberen van bestanden, dus lees wat ik over MacWhisper zeg met dat in gedachten. Elk feit over MacWhisper op deze pagina komt uit het helpartikel MacWhisper Command-Line Tool, gelezen op 10 oktober 2026.
Gratis te downloaden. Geen account, niets op slot, voor macOS 14 of nieuwer op een Mac met Apple chip. Broncode op GitHub.
Deze handleiding in andere talen: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
mw installeren
- Open MacWhisper, daarna Settings (instellingen) en dan Advanced (geavanceerd).
- Klik onder Command-Line Tool (opdrachtregelprogramma) op Install.
- Voer je Mac-wachtwoord in als macOS daarom vraagt. Dat is nodig om in /usr/local/bin te schrijven.
- Open een nieuw Terminal-venster en voer mw version uit.
Het programma komt op /usr/local/bin/mw te staan, en in het instellingenpaneel verschijnt een groen vinkje als het klaar is. Als mw version een versienummer toont, werkt het. Om het te verwijderen ga je terug naar hetzelfde paneel en klik je op Uninstall.
Een bestand transcriberen
mw transcribe ~/Desktop/meeting.m4a
mw transcribe meeting.m4a > transcript.txt
mw transcribe meeting.m4a -o transcript.txt
mw transcribe meeting.m4a | pbcopyWat er gebeurt: Het transcript wordt naar de standaarduitvoer geschreven. Een voortgangsregel gaat naar de standaardfoutuitvoer, dus een omgeleid bestand bevat alleen het transcript.
Standaard wordt een transcriptie vanaf de opdrachtregel niet bewaard. Ze wordt getoond en weggegooid, en komt alleen in de geschiedenis van MacWhisper terecht als je --persist toevoegt. Met Ctrl+C stop je een run. Een bestaand uitvoerbestand wordt nooit vervangen, tenzij je --overwrite toevoegt.
De commando's
Uit het helpartikel van MacWhisper, gelezen op 10 oktober 2026. Voeg --help toe aan een commando voor de bijbehorende opties.
| Commando | Wat het doet |
|---|---|
| mw | Een statusoverzicht: of de app bereikbaar is, het gekozen model, de gedownloade modellen en voorbeeldcommando's |
| mw version | Toont de versie van MacWhisper. Handig als verbindingscontrole |
| mw models list | Toont je geïnstalleerde transcriptiemodellen, met een ID per model |
| mw models select | Wijzigt het actieve model, in het opdrachtregelprogramma en in de app |
| mw transcribe | Transcribeert audio- of videobestanden, of hele mappen, en toont de tekst |
Opties voor mw transcribe
Uit hetzelfde artikel. Een taal die het gekozen model niet kan transcriberen, geeft een foutmelding.
| Optie | Wat het doet |
|---|---|
| --speakers, --no-speakers | Zet sprekerherkenning voor deze run aan of uit. Staat het aan, dan is het transcript per spreker gegroepeerd |
| --format | txt, de standaard, of srt, vtt, json, csv, md, html of avid |
| --style | transcript, subtitles of segments, dezelfde stijlen als in het exportpaneel van de app |
| --model | Gebruikt één model voor deze run zonder de keuze in de app te wijzigen |
| --language | Een ISO-code zoals en of de, of auto, of multilingual |
| --output, -o | Schrijft het transcript naar een bestand |
| --output-dir | Batchmodus. Schrijft één transcript per invoerbestand naar een map |
| --recursive | Neemt submappen mee als je een map opgeeft |
| --stream | Toont segmenten zodra ze klaar zijn. Alleen voor lokale engines |
| --persist | Bewaart de transcriptie in de geschiedenis van MacWhisper |
| --timestamps, --milliseconds, --group, --max-chars-per-line, --fps | Stemmen de indeling fijn af |
Formaten, en welke Pro nodig hebben
Uit hetzelfde artikel. De prijspagina van MacWhisper vertelt wat Pro kost.
| Formaat | Wat je krijgt | Licentie |
|---|---|---|
| txt | Platte tekst | Iedereen |
| srt | SubRip-ondertitels | Iedereen |
| vtt | WebVTT-ondertitels | Iedereen |
| csv | Rijen met begin, einde en transcript, plus spreker als die is herkend | Iedereen |
| json | Tijdstempels in milliseconden, sprekers per segment en woordtijden | Pro |
| md | Markdown met blokken met tijdstempels en kopjes per spreker | Pro |
| html | Een zelfstandig HTML-document | Pro |
| avid | Avid-ondertiteltekst met SMPTE-timecodes | Pro |
Hele mappen
mw transcribe ~/Recordings --recursive --output-dir ~/Transcripts
mw transcribe ~/Videos --output-dir ~/Subs --format srt
mw transcribe interview.m4a --speakers -o interview.txtWat er gebeurt: Elk invoerbestand krijgt een eigen bestand, vernoemd naar het origineel, en de mapstructuur wordt gespiegeld. Een bestand dat mislukt wordt gemeld en overgeslagen, en de run gaat door.
Sprekerherkenning heeft een model nodig dat dit ondersteunt. De pagina over sprekerherkenning behandelt dat deel van de app.
Als het niet werkt
- mw: command not found. Open een nieuw Terminal-venster, of voeg /usr/local/bin toe aan je PATH.
- Het loopt vast. Sluit MacWhisper af en open de app opnieuw, en probeer dan mw version.
- Een model-ID wordt niet herkend. Voer mw models list uit voor de exacte ID's, en download het model eerst in de app.
- Een Pro-foutmelding bij een formaat. json, md, html en avid hebben een Pro-licentie nodig.
- Een sandbox-fout. Een programma in een sandbox, waaronder sommige AI-codeertools, kan de toegang tot de socket van MacWhisper worden geweigerd. Voer mw rechtstreeks in Terminal uit.
De pagina over problemen met MacWhisper behandelt de app zelf.
Gratis routes vanuit Terminal
YapToText heeft geen opdrachtregelprogramma. De app transcribeert een bestand dat je erop sleept, één tegelijk, gratis naar platte tekst. Wil je Terminal gebruiken zonder iets te kopen, dan is whisper.cpp open source en is dat de engine waarop YapToText is gebouwd. De gids over Whisper op je eigen Mac bevat de commando's, en de pagina over open source transcriptiesoftware vergelijkt vier gratis tools.
Gratis te downloaden. Geen account, niets op slot, voor macOS 14 of nieuwer op een Mac met Apple chip. Broncode op GitHub.
Kort samengevat
- Installeren. Settings, Advanced, Command-Line Tool, Install.
- Uitvoeren. mw transcribe, gevolgd door een bestand of een map.
- Gratis formaten. txt, srt, vtt en csv.
- Pro-formaten. json, md, html en avid.
- Geschiedenis. Er wordt niets bewaard, tenzij je --persist toevoegt.
Past MacWhisper het programma aan en loopt deze pagina achter, open dan een issue op GitHub. Ik lees ze allemaal.
Gratis te downloaden. Geen account, niets op slot, voor macOS 14 of nieuwer op een Mac met Apple chip. Broncode op GitHub.
Handleidingen
Meer handleidingen, in het Engels
Bronnen
- https://docs.macwhisper.com/article/57-macwhisper-command-line-tool (bekeken op 10 oktober 2026)
- https://github.com/ryleighnewman/YapToText (bekeken op 10 oktober 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (bekeken op 10 oktober 2026)
Vragen
Heeft MacWhisper een opdrachtregelprogramma?
Ja. Het heet mw, en je installeert het via de instellingen van MacWhisper, onder Advanced, Command-Line Tool.
Hoe transcribeer ik een bestand met MacWhisper vanuit Terminal?
Voer mw transcribe uit, gevolgd door het pad van het bestand. Het transcript wordt naar de standaarduitvoer geschreven, of met -o naar een bestand.
Is de MacWhisper CLI gratis?
Volgens het helpartikel zijn txt, srt, vtt en csv beschikbaar voor iedereen, en hebben json, md, html en avid een Pro-licentie nodig.
Kan de MacWhisper CLI een hele map transcriberen?
Ja. Geef een map op bij mw transcribe, voeg --recursive toe voor submappen en --output-dir om één transcript per bestand te schrijven.
Moet MacWhisper open staan voor mw?
Het programma praat met de draaiende app en start MacWhisper automatisch als die niet open staat.