MacWhisperin CLI: asenna mw, litteroi Terminalista ja kaikki valitsimet
Teksti: Ryleigh Newman · Julkaistu
MacWhisperin mukana tulee komentorivityökalu nimeltä mw. Sillä ohjataan appia Terminalista: voit litteroida tiedostoja ja kokonaisia kansioita, tunnistaa puhujat, kirjoittaa tekstitykset tai JSONin sekä listata ja vaihtaa malleja. Työkalu puhuu käynnissä olevalle MacWhisper-apille paikallisen socketin kautta, joten se käyttää jo asettamiasi moottoreita, malleja ja asetuksia, ja se käynnistää apin, jos se ei ole auki.
Teen YapToTextia, toista Mac-appia sanelulle ja tiedostojen litteroinnille, joten lue MacWhisperista kirjoittamani sitä silmällä pitäen. Kaikki MacWhisperia koskevat tiedot tällä sivulla ovat sen ohjeartikkelista MacWhisper Command-Line Tool, jonka luin 10. lokakuuta 2026.
Ladattavissa ilmaiseksi. Ei tiliä eikä lukittuja ominaisuuksia. Vaatii macOS 14:n tai uudemman ja Macin, jossa on Applen siru. Lähdekoodi GitHubissa.
Tämä opas muilla kielillä: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Asenna mw
- Avaa MacWhisper, sitten Settings (asetukset) ja Advanced.
- Napsauta kohdassa Command-Line Tool (komentorivityökalu) painiketta Install.
- Anna Macin salasana, jos macOS kysyy sitä. Sitä tarvitaan, jotta tiedosto voidaan kirjoittaa kansioon /usr/local/bin.
- Avaa uusi Terminal-ikkuna ja aja mw version.
Työkalu asentuu polkuun /usr/local/bin/mw, ja asetusruudussa näkyy vihreä valintamerkki, kun asennus on valmis. Jos mw version tulostaa versionumeron, työkalu toimii. Voit poistaa sen palaamalla samaan ruutuun ja napsauttamalla Uninstall.
Litteroi tiedosto
mw transcribe ~/Desktop/meeting.m4a
mw transcribe meeting.m4a > transcript.txt
mw transcribe meeting.m4a -o transcript.txt
mw transcribe meeting.m4a | pbcopyMitä tapahtuu: Litterointi tulostuu vakiotulosteeseen. Edistymisrivi menee vakiovirheeseen, joten ohjattuun tiedostoon tulee vain litterointi.
Komentorivillä tehtyä litterointia ei oletuksena säilytetä. Se tulostetaan ja hylätään, ja se näkyy MacWhisperin historiassa vain, jos lisäät valitsimen --persist. Ctrl+C pysäyttää ajon. Olemassa olevaa tulostiedostoa ei koskaan korvata, ellet lisää valitsinta --overwrite.
Komennot
MacWhisperin ohjeartikkelista, luettuna 10. lokakuuta 2026. Lisää mihin tahansa komentoon --help, niin näet sen valitsimet.
| Komento | Mitä se tekee |
|---|---|
| mw | Tilayhteenveto: tavoittaako komento apin, valittu malli, ladatut mallit ja esimerkkikomennot |
| mw version | Tulostaa MacWhisperin version. Kätevä yhteyden tarkistukseen |
| mw models list | Listaa asennetut litterointimallit, kullekin oma tunniste |
| mw models select | Vaihtaa käytössä olevan mallin sekä komentorivityökalussa että appissa |
| mw transcribe | Litteroi ääni- tai videotiedostoja tai kokonaisia kansioita ja tulostaa tekstin |
Komennon mw transcribe valitsimet
Samasta artikkelista. Kieli, jota valittu malli ei osaa litteroida, päättyy virheeseen.
| Valitsin | Mitä se tekee |
|---|---|
| --speakers, --no-speakers | Laittaa puhujantunnistuksen päälle tai pois tältä ajolta. Kun se on päällä, litterointi ryhmitellään puhujan mukaan |
| --format | txt, oletus, tai srt, vtt, json, csv, md, html tai avid |
| --style | transcript, subtitles tai segments, samat tyylit kuin apin vientipaneelissa |
| --model | Käyttää yhtä mallia tämän ajon ajan muuttamatta apin valintaa |
| --language | ISO-koodi, kuten en tai de, tai auto tai multilingual |
| --output, -o | Kirjoittaa litteroinnin tiedostoon |
| --output-dir | Eräajo. Kirjoittaa yhden litteroinnin jokaista syötettä kohden kansioon |
| --recursive | Sisällyttää alikansiot, kun annat kansion |
| --stream | Tulostaa segmentit sitä mukaa kuin ne valmistuvat. Vain paikalliset moottorit |
| --persist | Säilyttää litteroinnin MacWhisperin historiassa |
| --timestamps, --milliseconds, --group, --max-chars-per-line, --fps | Hienosäätävät asettelua |
Formaatit ja mitkä niistä vaativat Pro-lisenssin
Samasta artikkelista. MacWhisperin hintasivu kertoo, mitä Pro maksaa.
| Formaatti | Mitä saat | Lisenssi |
|---|---|---|
| txt | Pelkkä teksti | Kaikki |
| srt | SubRip-tekstitykset | Kaikki |
| vtt | WebVTT-tekstitykset | Kaikki |
| csv | Rivit, joissa on alku, loppu ja litterointi sekä puhuja, kun se on tunnistettu | Kaikki |
| json | Aikaleimat millisekunnin tarkkuudella, puhujat segmenteittäin ja sanojen ajoitukset | Pro |
| md | Markdown, jossa on aikaleimalliset lohkot ja puhujien otsikot | Pro |
| html | Erillinen HTML-dokumentti | Pro |
| avid | Avidin tekstitysteksti SMPTE-aikakoodeilla | Pro |
Kokonaiset kansiot
mw transcribe ~/Recordings --recursive --output-dir ~/Transcripts
mw transcribe ~/Videos --output-dir ~/Subs --format srt
mw transcribe interview.m4a --speakers -o interview.txtMitä tapahtuu: Jokainen syöte saa oman tiedostonsa, joka nimetään sen mukaan, ja kansiorakenne peilataan. Epäonnistunut tiedosto raportoidaan ja ohitetaan, ja ajo jatkuu.
Puhujantunnistus vaatii mallin, joka tukee sitä. Puhujantunnistuksen sivu käsittelee appin sitä puolta.
Kun se ei toimi
- mw: command not found. Avaa uusi Terminal-ikkuna tai lisää /usr/local/bin PATH-muuttujaan.
- Komento jumittuu. Sulje MacWhisper ja avaa se uudelleen, kokeile sitten mw version.
- Mallin tunnistetta ei tunnisteta. Aja mw models list nähdäksesi tarkat tunnisteet ja lataa malli ensin appissa.
- Pro-virhe formaatista. Formaatit json, md, html ja avid vaativat Pro-lisenssin.
- Sandbox-virhe. Sandbox-ympäristössä toimivalta ohjelmalta, myös joiltakin tekoälyn koodaustyökaluilta, voi olla estetty pääsy MacWhisperin socketiin. Aja mw suoraan Terminalissa.
MacWhisperin vianmääritysivu käsittelee itse appia.
Ilmaiset reitit Terminalista
YapToTextilla ei ole komentorivityökalua. Se litteroi pudottamasi tiedoston kerrallaan pelkäksi tekstiksi, ilmaiseksi. Jos haluat Terminalin etkä halua ostaa mitään, whisper.cpp on avoimen lähdekoodin moottori, jonka päälle YapToText on rakennettu. Paikallisen Whisperin opas sisältää komennot, ja avoimen lähdekoodin litterointisivu vertailee neljää ilmaista työkalua.
Ladattavissa ilmaiseksi. Ei tiliä eikä lukittuja ominaisuuksia. Vaatii macOS 14:n tai uudemman ja Macin, jossa on Applen siru. Lähdekoodi GitHubissa.
Lyhyesti
- Asennus. Valitse Settings, Advanced, Command-Line Tool ja Install.
- Ajo. Kirjoita mw transcribe ja sen perään tiedosto tai kansio.
- Ilmaiset formaatit. txt, srt, vtt ja csv.
- Pro-formaatit. json, md, html ja avid.
- Historia. Mitään ei säilytetä, ellet lisää valitsinta --persist.
Jos MacWhisper muuttaa työkalua eikä tämä sivu pysy perässä, avaa issue GitHubissa. Luen jokaisen.
Ladattavissa ilmaiseksi. Ei tiliä eikä lukittuja ominaisuuksia. Vaatii macOS 14:n tai uudemman ja Macin, jossa on Applen siru. Lähdekoodi GitHubissa.
Oppaat
Lisää oppaita, englanniksi
Lähteet
- https://docs.macwhisper.com/article/57-macwhisper-command-line-tool (tarkistettu 10.10.2026)
- https://github.com/ryleighnewman/YapToText (tarkistettu 10.10.2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (tarkistettu 10.10.2026)
Kysymyksiä
Onko MacWhisperissä komentorivityökalu?
Kyllä. Sen nimi on mw, ja se asennetaan MacWhisperin asetuksista kohdasta Advanced, Command-Line Tool.
Miten litteroin tiedoston MacWhisperilla Terminalista?
Aja mw transcribe ja anna tiedoston polku. Litterointi tulostuu vakiotulosteeseen tai tiedostoon, jos käytät valitsinta -o.
Onko MacWhisper CLI ilmainen?
Sen ohjeartikkelin mukaan txt, srt, vtt ja csv ovat kaikkien käytettävissä, ja json, md, html ja avid vaativat Pro-lisenssin.
Voiko MacWhisper CLI litteroida kokonaisen kansion?
Kyllä. Anna kansio komennolle mw transcribe, lisää --recursive alikansioille ja --output-dir, jos haluat yhden litteroinnin jokaista tiedostoa kohden.
Pitääkö MacWhisperin olla auki, kun käytän mw:tä?
Työkalu puhuu käynnissä olevalle appille ja käynnistää MacWhisperin itse, jos se ei ole auki.