CLI-ul MacWhisper: cum instalați mw, cum transcrieți din Terminal și fiecare opțiune
Text: Ryleigh Newman · Publicat la
MacWhisper vine cu un instrument de linie de comandă numit mw. Acesta controlează aplicația din Terminal: transcrie fișiere și foldere întregi, detectează vorbitorii, scrie subtitrări sau JSON și afișează sau schimbă modelele. Comunică cu aplicația MacWhisper deschisă printr-un socket local, așa că folosește motoarele, modelele și configurările pe care le-ați făcut deja, iar dacă aplicația nu este deschisă, o pornește.
Am creat YapToText, o altă aplicație Mac pentru dictare și transcrierea fișierelor, așa că țineți cont de asta când citiți ce spun despre MacWhisper. Fiecare informație despre MacWhisper de aici provine din articolul său de ajutor MacWhisper Command-Line Tool, citit la 10 octombrie 2026.
Descărcare gratuită. Fără cont și fără funcții blocate, pentru macOS 14 sau ulterior pe un Mac cu cip Apple. Codul sursă pe GitHub.
Acest ghid în alte limbi: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Instalarea lui mw
- Deschideți MacWhisper, apoi Settings, apoi Advanced.
- La Command-Line Tool, faceți clic pe Install.
- Introduceți parola Mac-ului dacă macOS o cere. Este necesară pentru a scrie în /usr/local/bin.
- Deschideți o fereastră nouă Terminal și rulați mw version.
Instrumentul ajunge la /usr/local/bin/mw, iar panoul de configurări arată o bifă verde când instalarea s-a terminat. Dacă mw version afișează un număr de versiune, totul funcționează. Pentru a-l elimina, reveniți în același panou și faceți clic pe Uninstall.
Transcrierea unui fișier
mw transcribe ~/Desktop/meeting.m4a
mw transcribe meeting.m4a > transcript.txt
mw transcribe meeting.m4a -o transcript.txt
mw transcribe meeting.m4a | pbcopyCe se întâmplă: Transcrierea este afișată la ieșirea standard. O linie de progres merge la eroarea standard, așa că un fișier redirecționat conține doar transcrierea.
Implicit, o transcriere făcută din linia de comandă nu este păstrată. Este afișată și apoi aruncată, și apare în istoricul MacWhisper doar dacă adăugați --persist. Ctrl+C oprește o rulare. Un fișier de ieșire existent nu este niciodată înlocuit, decât dacă adăugați --overwrite.
Comenzile
Din articolul de ajutor al MacWhisper, citit la 10 octombrie 2026. Adăugați --help la orice comandă pentru opțiunile ei.
| Comanda | Ce face |
|---|---|
| mw | O imagine de ansamblu a stării: dacă aplicația răspunde, modelul ales, modelele descărcate și exemple de comenzi |
| mw version | Afișează versiunea MacWhisper. Util ca verificare a conexiunii |
| mw models list | Listează modelele de transcriere instalate, cu un ID pentru fiecare |
| mw models select | Schimbă modelul activ, atât în instrumentul de linie de comandă, cât și în aplicație |
| mw transcribe | Transcrie fișiere audio sau video, ori foldere întregi, și afișează textul |
Opțiunile pentru mw transcribe
Din același articol. O limbă pe care modelul ales nu o poate transcrie provoacă o eroare.
| Opțiunea | Ce face |
|---|---|
| --speakers, --no-speakers | Pornește sau oprește detectarea vorbitorilor pentru această rulare. Când este pornită, transcrierea este grupată pe vorbitori |
| --format | txt, implicit, sau srt, vtt, json, csv, md, html ori avid |
| --style | transcript, subtitles sau segments, aceleași stiluri ca în panoul Export al aplicației |
| --model | Folosește un model pentru această rulare, fără să schimbe selecția din aplicație |
| --language | Un cod ISO, cum ar fi en sau de, ori auto, ori multilingual |
| --output, -o | Scrie transcrierea într-un fișier |
| --output-dir | Mod în serie. Scrie într-un folder câte o transcriere pentru fiecare fișier de intrare |
| --recursive | Include subfolderele atunci când dați un folder |
| --stream | Afișează segmentele pe măsură ce sunt gata. Numai pentru motoarele locale |
| --persist | Păstrează transcrierea în istoricul MacWhisper |
| --timestamps, --milliseconds, --group, --max-chars-per-line, --fps | Ajustează fin aspectul |
Formatele și care necesită Pro
Din același articol. Pagina cu prețurile MacWhisper arată cât costă Pro.
| Formatul | Ce primiți | Licența |
|---|---|---|
| txt | Text simplu | Toți |
| srt | Subtitrări SubRip | Toți |
| vtt | Subtitrări WebVTT | Toți |
| csv | Rânduri cu început, sfârșit și transcriere, plus vorbitorul când este detectat | Toți |
| json | Marcaje de timp în milisecunde, vorbitori pe segment și timpi pe cuvânt | Pro |
| md | Markdown cu blocuri cu marcaje de timp și titluri cu vorbitorii | Pro |
| html | Un document HTML de sine stătător | Pro |
| avid | Text de subtitrare Avid cu timecode SMPTE | Pro |
Foldere întregi
mw transcribe ~/Recordings --recursive --output-dir ~/Transcripts
mw transcribe ~/Videos --output-dir ~/Subs --format srt
mw transcribe interview.m4a --speakers -o interview.txtCe se întâmplă: Fiecare fișier de intrare primește propriul fișier, cu numele lui, iar structura de foldere este reprodusă. Un fișier care eșuează este raportat și sărit, iar rularea continuă.
Detectarea vorbitorilor are nevoie de un model care o acceptă. Pagina despre recunoașterea vorbitorilor tratează această parte a aplicației.
Când nu funcționează
- mw: command not found. Deschideți o fereastră nouă Terminal sau adăugați /usr/local/bin la PATH.
- Se blochează. Închideți și redeschideți MacWhisper, apoi încercați mw version.
- Un ID de model nu este recunoscut. Rulați mw models list pentru ID-urile exacte și descărcați mai întâi modelul în aplicație.
- O eroare Pro la un format. json, md, html și avid necesită o licență Pro.
- O eroare de sandbox. Un program izolat în sandbox, inclusiv unele instrumente de programare cu AI, poate fi blocat să acceseze socketul MacWhisper. Rulați mw direct în Terminal.
Pagina de depanare MacWhisper tratează aplicația în sine.
Variante gratuite din Terminal
YapToText nu are instrument de linie de comandă. Transcrie, gratuit, un singur fișier odată, pe cel pe care îl trageți peste el, în text simplu. Dacă vreți Terminal și nu doriți să cumpărați nimic, whisper.cpp este open source și este motorul pe care este construit YapToText. Ghidul despre Whisper local conține comenzile, iar pagina despre transcrierea open source compară patru instrumente gratuite.
Descărcare gratuită. Fără cont și fără funcții blocate, pentru macOS 14 sau ulterior pe un Mac cu cip Apple. Codul sursă pe GitHub.
Pe scurt
- Instalare. Settings, Advanced, Command-Line Tool, Install.
- Rulare. mw transcribe, apoi un fișier sau un folder.
- Formate gratuite. txt, srt, vtt și csv.
- Formate Pro. json, md, html și avid.
- Istoric. Nimic nu se păstrează dacă nu adăugați --persist.
Dacă MacWhisper schimbă instrumentul și pagina rămâne în urmă, deschideți un issue pe GitHub. Le citesc pe toate.
Descărcare gratuită. Fără cont și fără funcții blocate, pentru macOS 14 sau ulterior pe un Mac cu cip Apple. Codul sursă pe GitHub.
Ghiduri
Alte ghiduri, în engleză
Surse
- https://docs.macwhisper.com/article/57-macwhisper-command-line-tool (verificat la 10.10.2026)
- https://github.com/ryleighnewman/YapToText (verificat la 10.10.2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (verificat la 10.10.2026)
Întrebări
Are MacWhisper un instrument de linie de comandă?
Da. Se numește mw și îl instalați din Settings în MacWhisper, la Advanced, Command-Line Tool.
Cum transcriu un fișier cu MacWhisper din Terminal?
Rulați mw transcribe urmat de calea fișierului. Transcrierea este afișată la ieșirea standard sau într-un fișier, cu -o.
Este CLI-ul MacWhisper gratuit?
Articolul său de ajutor spune că formatele txt, srt, vtt și csv sunt disponibile pentru toți, iar json, md, html și avid necesită o licență Pro.
Poate CLI-ul MacWhisper să transcrie un folder întreg?
Da. Dați un folder lui mw transcribe, adăugați --recursive pentru subfoldere și --output-dir pentru a scrie câte o transcriere pe fișier.
Are mw nevoie ca MacWhisper să fie deschis?
Comunică cu aplicația deschisă și pornește MacWhisper automat dacă nu este deschis.