CLI MacWhisper: instalacja mw, transkrypcja z Terminala i wszystkie flagi

Tekst: · Opublikowano

MacWhisper ma w zestawie narzędzie wiersza poleceń o nazwie mw. Steruje aplikacją z Terminala: transkrybuje pliki i całe foldery, rozpoznaje mówców, zapisuje napisy lub JSON oraz wyświetla i przełącza modele. Łączy się z działającą aplikacją MacWhisper przez lokalne gniazdo, więc korzysta z silników, modeli i ustawień, które już są skonfigurowane, a jeśli aplikacja nie jest otwarta, sam ją uruchamia.

Tworzę YapToText, inną aplikację na Maca do dyktowania i transkrypcji plików, więc czytaj to, co piszę o MacWhisper, z tą wiedzą. Każdy fakt o MacWhisper pochodzi tu z jego artykułu pomocy MacWhisper Command-Line Tool, czytanego 10 października 2026.

Pobierz YapToText z Mac App StoreDo pobrania za darmo. Bez konta i bez blokad, dla macOS 14 lub nowszego na Macu z układem Apple. Kod źródłowy na GitHubie.

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

Instalacja mw

  1. Otwórz MacWhisper, potem Settings (ustawienia), a potem Advanced (zaawansowane).
  2. W sekcji Command-Line Tool (narzędzie wiersza poleceń) kliknij Install (zainstaluj).
  3. Jeśli macOS o to poprosi, wpisz hasło do Maca. Jest potrzebne do zapisu w /usr/local/bin.
  4. Otwórz nowe okno Terminala i uruchom mw version.

Narzędzie trafia do /usr/local/bin/mw, a panel ustawień pokazuje zielony znacznik, gdy instalacja się zakończy. Jeśli mw version wypisze numer wersji, wszystko działa. Aby je usunąć, wróć do tego samego panelu i kliknij Uninstall (odinstaluj).

Transkrypcja pliku

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

Co się dzieje: Transkrypcja jest wypisywana na standardowe wyjście. Linia postępu trafia na standardowe wyjście błędów, więc przekierowany plik zawiera tylko transkrypcję.

Domyślnie transkrypcja z wiersza poleceń nie jest zachowywana. Jest wypisywana i odrzucana, a w historii MacWhisper pojawia się tylko wtedy, gdy dodasz --persist. Ctrl+C zatrzymuje uruchomienie. Istniejący plik wyjściowy nigdy nie jest zastępowany, chyba że dodasz --overwrite.

Polecenia

Z artykułu pomocy MacWhisper, czytanego 10 października 2026. Dodaj --help do dowolnego polecenia, aby zobaczyć jego opcje.

PolecenieCo robi
mwPrzegląd stanu: czy aplikacja jest osiągalna, wybrany model, pobrane modele i przykładowe polecenia
mw versionWypisuje wersję MacWhisper. Przydaje się do sprawdzenia połączenia
mw models listWyświetla zainstalowane modele transkrypcji, każdy z identyfikatorem
mw models selectZmienia aktywny model, w narzędziu wiersza poleceń i w aplikacji
mw transcribeTranskrybuje pliki audio lub wideo albo całe foldery i wypisuje tekst

Flagi polecenia mw transcribe

Z tego samego artykułu. Język, którego wybrany model nie potrafi transkrybować, kończy się błędem.

FlagaCo robi
--speakers, --no-speakersWłącza lub wyłącza rozpoznawanie mówców w tym uruchomieniu. Gdy jest włączone, transkrypcja jest pogrupowana według mówców
--formattxt (domyślnie) albo srt, vtt, json, csv, md, html lub avid
--styletranscript, subtitles lub segments, czyli te same style co w panelu Export aplikacji
--modelUżywa jednego modelu w tym uruchomieniu, bez zmiany wyboru w aplikacji
--languageKod ISO, taki jak en lub de, albo auto, albo multilingual
--output, -oZapisuje transkrypcję do pliku
--output-dirTryb wsadowy. Zapisuje po jednej transkrypcji dla każdego pliku wejściowego w wybranym folderze
--recursiveObejmuje podfoldery, gdy podasz folder
--streamWypisuje segmenty, gdy tylko są gotowe. Tylko z silnikami lokalnymi
--persistZachowuje transkrypcję w historii MacWhisper
--timestamps, --milliseconds, --group, --max-chars-per-line, --fpsDopracowują układ

Formaty i te, które wymagają Pro

Z tego samego artykułu. Strona z cennikiem MacWhisper podaje, ile kosztuje Pro.

FormatCo dostajeszLicencja
txtZwykły tekstWszyscy
srtNapisy SubRipWszyscy
vttNapisy WebVTTWszyscy
csvWiersze z początkiem, końcem i transkrypcją, a po wykryciu także z mówcąWszyscy
jsonZnaczniki czasu w milisekundach, mówcy w każdym segmencie i czasy poszczególnych słówPro
mdMarkdown z blokami ze znacznikami czasu i nagłówkami mówcówPro
htmlSamodzielny dokument HTMLPro
avidTekst napisów Avid z kodami czasowymi SMPTEPro

Całe foldery

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

Co się dzieje: Każdy plik wejściowy dostaje własny plik wyjściowy, nazwany tak samo, a struktura folderów jest odtwarzana. Plik, którego przetworzenie się nie powiedzie, jest zgłaszany i pomijany, a praca trwa dalej.

Rozpoznawanie mówców wymaga modelu, który je obsługuje. Strona o rozpoznawaniu mówców opisuje tę część aplikacji.

Gdy to nie działa

  • mw: command not found. Otwórz nowe okno Terminala albo dodaj /usr/local/bin do zmiennej PATH.
  • Zawiesza się. Zamknij i ponownie otwórz MacWhisper, a potem spróbuj mw version.
  • Identyfikator modelu nie jest rozpoznawany. Uruchom mw models list, aby zobaczyć dokładne identyfikatory, i najpierw pobierz model w aplikacji.
  • Błąd Pro przy formacie. Formaty json, md, html i avid wymagają licencji Pro.
  • Błąd piaskownicy. Program działający w piaskownicy, w tym niektóre narzędzia do kodowania z AI, może mieć zablokowany dostęp do gniazda MacWhisper. Uruchom mw bezpośrednio w Terminalu.

Strona z rozwiązywaniem problemów MacWhisper opisuje samą aplikację.

Darmowe drogi z Terminala

YapToText nie ma narzędzia wiersza poleceń. Transkrybuje plik, który na niego upuścisz, po jednym naraz, do zwykłego tekstu i za darmo. Jeśli chcesz pracować w Terminalu i niczego nie kupować, whisper.cpp jest otwartoźródłowy i jest silnikiem, na którym zbudowano YapToText. Poradnik o lokalnym Whisper zawiera polecenia, a strona o otwartoźródłowym oprogramowaniu do transkrypcji porównuje cztery darmowe narzędzia.

Pobierz YapToText z Mac App StoreDo pobrania za darmo. Bez konta i bez blokad, dla macOS 14 lub nowszego na Macu z układem Apple. Kod źródłowy na GitHubie.

W skrócie

  • Instalacja. W MacWhisper: Settings, Advanced, Command-Line Tool, Install.
  • Uruchomienie. mw transcribe, a po nim plik lub folder.
  • Darmowe formaty. txt, srt, vtt i csv.
  • Formaty Pro. json, md, html i avid.
  • Historia. Nic nie jest zachowywane, dopóki nie dodasz --persist.

Jeśli MacWhisper zmieni to narzędzie, a ta strona się zdezaktualizuje, otwórz zgłoszenie na GitHubie. Czytam każde zgłoszenie.

Pobierz YapToText z Mac App StoreDo pobrania za darmo. Bez konta i bez blokad, dla macOS 14 lub nowszego na Macu z układem Apple. Kod źródłowy na GitHubie.

Kto to pisze. Ryleigh Newman tworzy oprogramowanie, ma trudności z pisaniem na klawiaturze i codziennie dyktuje w YapToText, aplikacji opisanej na tej stronie. Ta strona jest tłumaczeniem z angielskiego. Interfejs aplikacji i reszta witryny są po angielsku. Więcej o projekcie, po angielsku.

Poradniki

Więcej poradników, po angielsku

Źródła

Pytania

Czy MacWhisper ma narzędzie wiersza poleceń?

Tak. Nazywa się mw i instaluje się je w ustawieniach MacWhisper, w sekcji Advanced, Command-Line Tool.

Jak transkrybować plik w MacWhisper z Terminala?

Uruchom mw transcribe, a po nim ścieżkę do pliku. Transkrypcja jest wypisywana na standardowe wyjście albo trafia do pliku, jeśli dodasz -o.

Czy CLI MacWhisper jest darmowe?

Jego artykuł pomocy podaje, że wyjście txt, srt, vtt i csv jest dostępne dla wszystkich, a json, md, html i avid wymagają licencji Pro.

Czy CLI MacWhisper może transkrybować cały folder?

Tak. Podaj folder do mw transcribe, dodaj --recursive dla podfolderów, a --output-dir, aby zapisać po jednej transkrypcji dla każdego pliku.

Czy mw wymaga otwartej aplikacji MacWhisper?

Łączy się z działającą aplikacją i sam uruchamia MacWhisper, jeśli nie jest otwarty.