MacWhisper CLI: inštalácia mw, prepis z Terminalu a všetky voľby

Text: · Zverejnené

MacWhisper obsahuje nástroj príkazového riadka s názvom mw. Ovláda aplikáciu z okna Terminal (príkazový riadok): prepisuje súbory aj celé priečinky, rozpoznáva rečníkov, píše titulky alebo JSON a zobrazuje či prepína modely. S bežiacou aplikáciou MacWhisper komunikuje cez lokálny soket, takže používa nástroje, modely a nastavenia, ktoré ste už pripravili, a ak aplikácia nie je otvorená, spustí ju.

Vyvíjam YapToText, inú aplikáciu pre Mac na diktovanie a prepis súborov, takže berte to, čo píšem o MacWhisper, s týmto vedomím. Každý fakt o MacWhisper je tu z jeho článku pomocníka MacWhisper Command-Line Tool, prečítaného 10. októbra 2026.

Stiahnuť YapToText v Mac App StoreNa stiahnutie zadarmo. Bez účtu a bez zamknutých funkcií, pre macOS 14 alebo novší na Macu s čipom Apple. Zdrojový kód na GitHube.

Tento návod v ďalších jazykoch: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文

Inštalácia mw

  1. Otvorte MacWhisper, potom Settings (nastavenia) a Advanced (rozšírené).
  2. V časti Command-Line Tool kliknite na Install.
  3. Ak sa macOS opýta, zadajte heslo svojho Macu. Je potrebné na zápis do /usr/local/bin.
  4. Otvorte nové okno Terminal a spustite mw version.

Nástroj sa uloží do /usr/local/bin/mw a keď je hotovo, panel nastavení ukáže zelenú značku. Ak mw version vypíše číslo verzie, funguje. Ak ho chcete odstrániť, vráťte sa na ten istý panel a kliknite na Uninstall.

Prepis súboru

mw transcribe ~/Desktop/meeting.m4a
mw transcribe meeting.m4a > transcript.txt
mw transcribe meeting.m4a -o transcript.txt
mw transcribe meeting.m4a | pbcopy

Čo sa stane: Prepis sa vypíše na štandardný výstup. Riadok s priebehom ide na štandardný chybový výstup, takže presmerovaný súbor obsahuje len prepis.

Prepis z príkazového riadka sa predvolene neuchováva. Vypíše sa a zahodí a v histórii MacWhisper sa objaví, len ak pridáte --persist. Beh zastavíte kombináciou Ctrl+C. Existujúci výstupný súbor sa nikdy nenahradí, kým nepridáte --overwrite.

Príkazy

Z článku pomocníka MacWhisper, prečítaného 10. októbra 2026. K ľubovoľnému príkazu pridajte --help a zobrazia sa jeho voľby.

PríkazČo robí
mwPrehľad stavu: či je aplikácia dostupná, vybraný model, stiahnuté modely a príklady príkazov
mw versionVypíše verziu MacWhisper. Hodí sa na kontrolu spojenia
mw models listVypíše nainštalované modely prepisu, každý s ID
mw models selectZmení aktívny model, v nástroji príkazového riadka aj v aplikácii
mw transcribePrepíše zvukové alebo video súbory, či celé priečinky, a vypíše text

Voľby príkazu mw transcribe

Z toho istého článku. Jazyk, ktorý zvolený model nevie prepísať, skončí chybou.

VoľbaČo robí
--speakers, --no-speakersZapne alebo vypne rozpoznávanie rečníkov pre tento beh. Keď je zapnuté, prepis je zoskupený podľa rečníkov
--formattxt, predvolene, alebo srt, vtt, json, csv, md, html či avid
--styletranscript, subtitles alebo segments, rovnaké štýly ako na paneli Export v aplikácii
--modelPoužije jeden model pre tento beh bez zmeny výberu v aplikácii
--languageKód ISO, napríklad en alebo de, alebo auto, alebo multilingual
--output, -oZapíše prepis do súboru
--output-dirDávkový režim. Zapíše jeden prepis pre každý vstup do priečinka
--recursiveZahrnie podpriečinky, keď zadáte priečinok
--streamVypisuje segmenty, len čo sú hotové. Len lokálne nástroje
--persistPonechá prepis v histórii MacWhisper
--timestamps, --milliseconds, --group, --max-chars-per-line, --fpsDoladia rozloženie

Formáty a ktoré vyžadujú Pro

Z toho istého článku. Stránka s cenami MacWhisper uvádza, koľko stojí Pro.

FormátČo dostaneteLicencia
txtČistý textVšetci
srtTitulky SubRipVšetci
vttTitulky WebVTTVšetci
csvRiadky so začiatkom, koncom a prepisom, a s rečníkom, ak sa rozpoznalVšetci
jsonČasové značky v milisekundách, rečníci pre každý segment a časovanie slovPro
mdMarkdown s blokmi s časovými značkami a nadpismi rečníkovPro
htmlSamostatný dokument HTMLPro
avidText titulkov Avid s časovými kódmi SMPTEPro

Celé priečinky

mw transcribe ~/Recordings --recursive --output-dir ~/Transcripts
mw transcribe ~/Videos --output-dir ~/Subs --format srt
mw transcribe interview.m4a --speakers -o interview.txt

Čo sa stane: Každý vstup dostane vlastný súbor pomenovaný podľa neho a štruktúra priečinkov sa zachová. Súbor, ktorý zlyhá, sa ohlási a preskočí a beh pokračuje.

Rozpoznávanie rečníkov vyžaduje model, ktorý ho podporuje. Stránka o rozpoznávaní rečníkov pokrýva túto stránku aplikácie.

Keď to nefunguje

  • mw: command not found. Otvorte nové okno Terminal alebo pridajte /usr/local/bin do svojej premennej PATH.
  • Zasekne sa. Ukončite a znova otvorte MacWhisper a skúste mw version.
  • ID modelu sa nerozpozná. Spustite mw models list, aby ste videli presné ID, a model si najprv stiahnite v aplikácii.
  • Chyba Pro pri formáte. Formáty json, md, html a avid vyžadujú licenciu Pro.
  • Chyba sandboxu. Program v sandboxe, vrátane niektorých nástrojov na programovanie s AI, môže mať zablokovaný prístup k soketu MacWhisper. Spúšťajte mw priamo v okne Terminal.

Samotnú aplikáciu pokrýva stránka o riešení problémov s MacWhisper.

Bezplatné cesty z príkazového riadka

YapToText nemá nástroj príkazového riadka. Prepíše súbor, ktorý naň pustíte, vždy jeden naraz, do čistého textu a zadarmo. Ak chcete príkazový riadok a nič kupovať, whisper.cpp má otvorený zdrojový kód a je to nástroj, na ktorom YapToText stojí. Návod na lokálny Whisper obsahuje príkazy a stránka o prepise s otvoreným kódom porovnáva štyri bezplatné nástroje.

Stiahnuť YapToText v Mac App StoreNa stiahnutie zadarmo. Bez účtu a bez zamknutých funkcií, pre macOS 14 alebo novší na Macu s čipom Apple. Zdrojový kód na GitHube.

Stručne

  • Inštalácia. Settings, Advanced, Command-Line Tool, Install.
  • Spustenie. mw transcribe a potom súbor alebo priečinok.
  • Bezplatné formáty. txt, srt, vtt a csv.
  • Formáty Pro. json, md, html a avid.
  • História. Nič sa neuchová, kým nepridáte --persist.

Ak MacWhisper nástroj zmení a táto stránka zostane pozadu, založte issue na GitHub. Čítam všetky.

Stiahnuť YapToText v Mac App StoreNa stiahnutie zadarmo. Bez účtu a bez zamknutých funkcií, pre macOS 14 alebo novší na Macu s čipom Apple. Zdrojový kód na GitHube.

Kto píše. Ryleigh Newman vyvíja softvér, písanie na klávesnici zvláda len s ťažkosťami a každý deň diktuje v YapToText, aplikácii, o ktorej je tento web. Táto stránka je preložená z angličtiny. Rozhranie aplikácie a zvyšok webu sú v angličtine. Viac o projekte, po anglicky.

Ďalšie návody, po anglicky

Zdroje

Otázky

Má MacWhisper nástroj príkazového riadka?

Áno. Volá sa mw a inštalujete ho v nastaveniach MacWhisper, v časti Advanced, Command-Line Tool.

Ako prepíšem súbor v MacWhisper z Terminalu?

Spustite mw transcribe a za ním cestu k súboru. Prepis sa vypíše na štandardný výstup alebo do súboru pomocou -o.

Je CLI v MacWhisper zadarmo?

Jeho článok pomocníka uvádza, že výstupy txt, srt, vtt a csv sú dostupné všetkým a že json, md, html a avid vyžadujú licenciu Pro.

Vie CLI v MacWhisper prepísať celý priečinok?

Áno. Zadajte priečinok príkazu mw transcribe, pridajte --recursive pre podpriečinky a --output-dir, aby sa zapísal jeden prepis pre každý súbor.

Musí byť MacWhisper pre mw otvorený?

Komunikuje s bežiacou aplikáciou a ak MacWhisper nie je otvorený, automaticky ho spustí.