MacWhisper CLI: instalace mw, přepis z Terminalu a všechny přepínače

Text: · Zveřejněno

MacWhisper obsahuje nástroj příkazového řádku jménem mw. Ovládá aplikaci z aplikace Terminal: přepisuje soubory i celé složky, rozpoznává mluvčí, píše titulky nebo JSON a vypisuje či přepíná modely. S běžící aplikací MacWhisper komunikuje přes místní socket, takže používá enginy, modely a nastavení, která už máte, a pokud aplikace neběží, spustí ji.

Vyvíjím YapToText, jinou aplikaci pro Mac na diktování a přepis souborů, proto to, co o MacWhisper píšu, čtěte s ohledem na to. Každý fakt o MacWhisper tu pochází z jeho článku nápovědy MacWhisper Command-Line Tool, přečteného 10. října 2026.

Stáhnout YapToText v Mac App StoruKe stažení zdarma. Bez účtu a bez zamčených funkcí, pro macOS 14 nebo novější na Macu s čipem Apple. Zdrojový kód na GitHubu.

Tento návod v dalších jazycích: English, العربية, Dansk, 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, 简体中文, 繁體中文

Instalace mw

  1. Otevřete MacWhisper, potom Settings (nastavení) a Advanced (pokročilé).
  2. V části Command-Line Tool (nástroj příkazového řádku) klikněte na Install (nainstalovat).
  3. Pokud o to macOS požádá, zadejte heslo k Macu. Je potřeba k zápisu do /usr/local/bin.
  4. Otevřete nové okno aplikace Terminal a spusťte mw version.

Nástroj se uloží do /usr/local/bin/mw a po dokončení se v podokně nastavení zobrazí zelená fajfka. Pokud mw version vypíše číslo verze, nástroj funguje. Odstraníte ho ve stejném podokně tlačítkem Uninstall (odinstalovat).

Přepis souboru

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

Co se stane: Přepis se vypíše na standardní výstup. Řádek s průběhem jde na standardní chybový výstup, takže soubor, do kterého výstup přesměrujete, obsahuje jen přepis.

Přepis z příkazového řádku se ve výchozím stavu neukládá. Vypíše se a zahodí a v historii MacWhisper se objeví jen tehdy, když přidáte --persist. Ctrl+C běh zastaví. Existující výstupní soubor se nikdy nepřepíše, pokud nepřidáte --overwrite.

Příkazy

Z článku nápovědy MacWhisper, přečteného 10. října 2026. U libovolného příkazu zobrazíte jeho volby přidáním --help.

PříkazCo dělá
mwPřehled stavu: zda je aplikace dostupná, vybraný model, stažené modely a příklady příkazů
mw versionVypíše verzi MacWhisper. Hodí se jako kontrola spojení
mw models listVypíše nainstalované modely pro přepis, každý s ID
mw models selectZmění aktivní model v nástroji příkazového řádku i v aplikaci
mw transcribePřepíše zvukové nebo video soubory či celé složky a vypíše text

Přepínače příkazu mw transcribe

Ze stejného článku. Jazyk, který zvolený model přepsat neumí, skončí chybou.

PřepínačCo dělá
--speakers, --no-speakersZapne nebo vypne rozpoznávání mluvčích pro tento běh. Když je zapnuté, přepis je seskupený podle mluvčích
--formattxt, výchozí, nebo srt, vtt, json, csv, md, html či avid
--styletranscript, subtitles nebo segments, stejné styly jako na panelu exportu v aplikaci
--modelPoužije pro tento běh jeden model, aniž by změnil výběr v aplikaci
--languageKód ISO, například en nebo de, nebo auto, či multilingual
--output, -oZapíše přepis do souboru
--output-dirDávkový režim. Zapíše do složky jeden přepis na každý vstup
--recursiveZahrne podsložky, když předáte složku
--streamVypisuje segmenty hned, jak jsou hotové. Jen s místními enginy
--persistPonechá přepis v historii MacWhisper
--timestamps, --milliseconds, --group, --max-chars-per-line, --fpsDoladí vzhled výstupu

Formáty a které vyžadují Pro

Ze stejného článku. Kolik Pro stojí, popisuje stránka s cenami MacWhisper.

FormátCo dostaneteLicence
txtProstý textVšichni
srtTitulky SubRipVšichni
vttTitulky WebVTTVšichni
csvŘádky se začátkem, koncem a přepisem, a mluvčím, pokud byl rozpoznánVšichni
jsonČasové značky v milisekundách, mluvčí u každého segmentu a časování slovPro
mdMarkdown s bloky s časovými značkami a nadpisy mluvčíchPro
htmlSamostatný dokument HTMLPro
avidText titulků pro Avid s časovými kódy SMPTEPro

Celé složky

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

Co se stane: Každý vstup dostane vlastní soubor pojmenovaný podle něj a struktura složek se zachová. Soubor, který selže, se ohlásí a přeskočí a běh pokračuje.

Rozpoznávání mluvčích potřebuje model, který ho podporuje. Tuto stránku aplikace popisuje stránka o rozpoznávání mluvčích.

Když to nefunguje

  • mw: command not found. Otevřete nové okno aplikace Terminal nebo přidejte /usr/local/bin do proměnné PATH.
  • Příkaz visí. Ukončete MacWhisper, znovu ho otevřete a zkuste mw version.
  • ID modelu se nerozpozná. Přesná ID zjistíte příkazem mw models list a model si nejdřív stáhněte v aplikaci.
  • Chyba kvůli Pro u formátu. Formáty json, md, html a avid vyžadují licenci Pro.
  • Chyba sandboxu. Program v sandboxu, včetně některých nástrojů AI pro programování, může mít zablokovaný přístup k socketu MacWhisper. Spusťte mw přímo v aplikaci Terminal.

Samotnou aplikaci řeší stránka o potížích s MacWhisper.

Bezplatné cesty z Terminalu

YapToText nemá nástroj příkazového řádku. Přepisuje soubor, který na něj přetáhnete, vždy jeden, do prostého textu a zdarma. Pokud chcete příkazový řádek a nic si nekupovat, whisper.cpp má otevřený kód a je to engine, na kterém YapToText stojí. Příkazy najdete v návodu k místnímu Whisper a stránka o přepisu s otevřeným kódem srovnává čtyři bezplatné nástroje.

Stáhnout YapToText v Mac App StoruKe stažení zdarma. Bez účtu a bez zamčených funkcí, pro macOS 14 nebo novější na Macu s čipem Apple. Zdrojový kód na GitHubu.

Stručně

  • Instalace. Settings, Advanced, Command-Line Tool, Install.
  • Spuštění. mw transcribe a za ním soubor nebo složka.
  • Bezplatné formáty. txt, srt, vtt a csv.
  • Formáty Pro. json, md, html a avid.
  • Historie. Nic se neukládá, pokud nepřidáte --persist.

Pokud MacWhisper nástroj změní a stránka za ním zaostane, založte issue na GitHubu. Čtu všechna.

Stáhnout YapToText v Mac App StoruKe stažení zdarma. Bez účtu a bez zamčených funkcí, pro macOS 14 nebo novější na Macu s čipem Apple. Zdrojový kód na GitHubu.

Kdo píše. Ryleigh Newman vyvíjí software, psaní na klávesnici zvládá jen s obtížemi a každý den diktuje v YapToText, aplikaci, o které je tento web. Tato stránka je přeložená z angličtiny. Rozhraní aplikace a zbytek webu jsou v angličtině. Více o projektu, anglicky.

Další návody, anglicky

Zdroje

Otázky

Má MacWhisper nástroj příkazového řádku?

Ano. Jmenuje se mw a nainstalujete ho v nastavení MacWhisper, v části Advanced, Command-Line Tool.

Jak přepsat soubor v MacWhisper z Terminalu?

Spusťte mw transcribe a za něj zadejte cestu k souboru. Přepis se vypíše na standardní výstup, nebo do souboru, pokud přidáte -o.

Je MacWhisper CLI zdarma?

Jeho článek nápovědy říká, že výstup txt, srt, vtt a csv je dostupný všem a že json, md, html a avid vyžadují licenci Pro.

Umí MacWhisper CLI přepsat celou složku?

Ano. Předejte složku příkazu mw transcribe, přidejte --recursive pro podsložky a --output-dir, aby vznikl jeden přepis na každý soubor.

Musí být MacWhisper při použití mw otevřený?

Nástroj komunikuje s běžící aplikací a pokud MacWhisper není otevřený, sám ho spustí.