A MacWhisper CLI: az mw telepítése, átírás Terminalból és minden kapcsoló
Írta: Ryleigh Newman · Megjelent:
A MacWhisper egy mw nevű parancssori eszközzel érkezik. Ezzel a Terminalból vezérelheted az alkalmazást: fájlokat és egész mappákat írhatsz át, felismerheted a beszélőket, feliratot vagy JSON-t írhatsz ki, és modelleket listázhatsz vagy válthatsz. A futó MacWhisper alkalmazással helyi socketen keresztül beszél, ezért azokat a motorokat, modelleket és beállításokat használja, amelyeket már beállítottál, és elindítja az alkalmazást, ha az nincs megnyitva.
Én fejlesztem a YapToTextet, egy másik Mac-alkalmazást diktáláshoz és fájlok átírásához, ezért ezt tartsd szem előtt, amikor azt olvasod, amit a MacWhisperről írok. Minden itteni MacWhisper-tény a MacWhisper Command-Line Tool súgócikkből származik, amelyet 2026. október 10-én olvastam el.
Ingyen letölthető. Nincs fiók és nincsenek zárolt funkciók. Apple chippel szerelt Mac és macOS 14 vagy újabb kell hozzá. Forráskód a GitHubon.
Ez az útmutató más nyelveken: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Az mw telepítése
- Nyisd meg a MacWhispert, majd a Settings (beállítások), azon belül az Advanced (speciális) részt.
- A Command-Line Tool (parancssori eszköz) alatt kattints az Install (telepítés) gombra.
- Ha a macOS kéri, add meg a Mac jelszavát. Erre azért van szükség, hogy a rendszer írni tudjon a /usr/local/bin mappába.
- Nyiss egy új Terminal-ablakot, és futtasd az mw version parancsot.
Az eszköz a /usr/local/bin/mw helyre kerül, és a beállítások panelen zöld pipa jelzi, ha kész. Ha az mw version kiír egy verziószámot, működik. Az eltávolításhoz térj vissza ugyanerre a panelre, és kattints az Uninstall gombra.
Fájl átírása
mw transcribe ~/Desktop/meeting.m4a
mw transcribe meeting.m4a > transcript.txt
mw transcribe meeting.m4a -o transcript.txt
mw transcribe meeting.m4a | pbcopyEz történik: Az átirat a szabványos kimenetre íródik. Az előrehaladást jelző sor a szabványos hibakimenetre megy, így az átirányított fájlban csak az átirat van.
Alapból a parancssori átírást a program nem őrzi meg. Kiírja, majd eldobja, és csak akkor jelenik meg a MacWhisper előzményeiben, ha hozzáadod a --persist kapcsolót. A Ctrl+C leállítja a futást. Meglévő kimeneti fájlt a program soha nem cserél le, hacsak nem adod hozzá a --overwrite kapcsolót.
A parancsok
A MacWhisper súgócikkéből, 2026. október 10-i olvasat. Bármelyik parancshoz add hozzá a --help kapcsolót, és megkapod a lehetőségeit.
| Parancs | Mit csinál |
|---|---|
| mw | Állapotáttekintés: elérhető-e az alkalmazás, melyik modell van kiválasztva, mely modellek vannak letöltve, és példaparancsok |
| mw version | Kiírja a MacWhisper verzióját. Kapcsolatellenőrzésnek jó |
| mw models list | Felsorolja a telepített átírási modelleket, mindegyiket azonosítóval |
| mw models select | Megváltoztatja az aktív modellt, a parancssori eszközben és az alkalmazásban is |
| mw transcribe | Hang- vagy videofájlokat, illetve egész mappákat ír át, és kiírja a szöveget |
Az mw transcribe kapcsolói
Ugyanabból a cikkből. Ha a kiválasztott modell nem tudja átírni a megadott nyelvet, a parancs hibával leáll.
| Kapcsoló | Mit csinál |
|---|---|
| --speakers, --no-speakers | Ennél a futásnál be- vagy kikapcsolja a beszélőfelismerést. Bekapcsolva az átirat beszélők szerint van csoportosítva |
| --format | txt, ez az alapérték, vagy srt, vtt, json, csv, md, html vagy avid |
| --style | transcript, subtitles vagy segments, ugyanazok a stílusok, mint az alkalmazás Export paneljén |
| --model | Egy modellt használ ennél a futásnál, az alkalmazás kiválasztását nem változtatja meg |
| --language | ISO-kód, például en vagy de, vagy auto, vagy multilingual |
| --output, -o | Fájlba írja az átiratot |
| --output-dir | Kötegelt mód. Bemenetenként egy átiratot ír egy mappába |
| --recursive | Az almappákat is bevonja, ha mappát adsz meg |
| --stream | A szegmenseket kiírja, ahogy elkészülnek. Csak helyi motorokkal |
| --persist | Megőrzi az átírást a MacWhisper előzményeiben |
| --timestamps, --milliseconds, --group, --max-chars-per-line, --fps | A kimenet elrendezésének finomhangolása |
Formátumok, és melyikhez kell Pro
Ugyanabból a cikkből. A MacWhisper árazási oldala leírja, mennyibe kerül a Pro.
| Formátum | Mit kapsz | Licenc |
|---|---|---|
| txt | Egyszerű szöveg | Mindenki |
| srt | SubRip feliratok | Mindenki |
| vtt | WebVTT feliratok | Mindenki |
| csv | Sorok a kezdettel, a véggel és az átirattal, felismert beszélő esetén a beszélővel is | Mindenki |
| json | Ezredmásodperces időbélyegek, szegmensenkénti beszélők és szavankénti időzítések | Pro |
| md | Markdown időbélyeges blokkokkal és beszélőcímsorokkal | Pro |
| html | Önálló HTML-dokumentum | Pro |
| avid | Avid feliratszöveg SMPTE időkóddal | Pro |
Egész mappák
mw transcribe ~/Recordings --recursive --output-dir ~/Transcripts
mw transcribe ~/Videos --output-dir ~/Subs --format srt
mw transcribe interview.m4a --speakers -o interview.txtEz történik: Minden bemenet saját fájlt kap, amely a bemenet nevét viseli, és a mappaszerkezet tükrözve megmarad. A sikertelen fájlról jelentést kapsz, a program kihagyja, a futás pedig folytatódik.
A beszélőfelismeréshez olyan modell kell, amely támogatja. A beszélőfelismerésről szóló oldal az alkalmazásnak ezt az oldalát tárgyalja.
Ha nem működik
- mw: command not found. Nyiss egy új Terminal-ablakot, vagy add hozzá a /usr/local/bin mappát a PATH-hoz.
- Lefagy. Lépj ki a MacWhisperből, nyisd meg újra, majd próbáld az mw version parancsot.
- Nem ismeri fel a modellazonosítót. Futtasd az mw models list parancsot a pontos azonosítókért, és a modellt előbb töltsd le az alkalmazásban.
- Licencre utaló hiba egy formátumnál. A json, md, html és avid formátumhoz Pro licenc kell.
- Sandbox-hiba. Egy sandboxban futó programot, köztük néhány MI-alapú kódolóeszközt, kizárhat a MacWhisper socketjéből a rendszer. Az mw parancsot közvetlenül a Terminalban futtasd.
A MacWhisper hibaelhárítási oldala magát az alkalmazást tárgyalja.
Ingyenes megoldások Terminalból
A YapToTextnek nincs parancssori eszköze. Egyszerre egy ráhúzott fájlt ír át egyszerű szöveggé, ingyen. Ha Terminalt szeretnél, és nem akarsz semmit megvenni, a whisper.cpp nyílt forráskódú, és ez az a motor, amelyre a YapToText épül. A helyi Whisper útmutató tartalmazza a parancsokat, a nyílt forráskódú átírásról szóló oldal pedig négy ingyenes eszközt hasonlít össze.
Ingyen letölthető. Nincs fiók és nincsenek zárolt funkciók. Apple chippel szerelt Mac és macOS 14 vagy újabb kell hozzá. Forráskód a GitHubon.
A rövid változat
- Telepítés. A Settings, Advanced, Command-Line Tool, Install útvonalon.
- Futtatás. Az mw transcribe parancs, utána egy fájl vagy egy mappa.
- Ingyenes formátumok. A txt, srt, vtt és csv.
- Pro formátumok. A json, md, html és avid.
- Előzmények. Semmi nem marad meg, ha nem adod hozzá a --persist kapcsolót.
Ha a MacWhisper megváltoztatja az eszközt, és ez az oldal lemarad, nyiss egy issue-t a GitHubon. Mindet elolvasom.
Ingyen letölthető. Nincs fiók és nincsenek zárolt funkciók. Apple chippel szerelt Mac és macOS 14 vagy újabb kell hozzá. Forráskód a GitHubon.
Útmutatók
További útmutatók, angolul
Források
- https://docs.macwhisper.com/article/57-macwhisper-command-line-tool (ellenőrizve 2026. 10. 10.)
- https://github.com/ryleighnewman/YapToText (ellenőrizve 2026. 10. 10.)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (ellenőrizve 2026. 10. 10.)
Kérdések
Van parancssori eszköze a MacWhispernek?
Igen. A neve mw, és a MacWhisper Settings részében, az Advanced, Command-Line Tool alatt telepítheted.
Hogyan írok át fájlt a MacWhisperrel Terminalból?
Futtasd az mw transcribe parancsot, utána add meg a fájl útvonalát. Az átirat a szabványos kimenetre íródik, vagy a -o kapcsolóval fájlba.
Ingyenes a MacWhisper CLI?
A súgócikke szerint a txt, srt, vtt és csv kimenet mindenkinek elérhető, a json, md, html és avid formátumhoz viszont Pro licenc kell.
Át tud írni a MacWhisper CLI egy egész mappát?
Igen. Adj meg egy mappát az mw transcribe parancsnak, az almappákhoz add hozzá a --recursive, fájlonként egy átirathoz pedig a --output-dir kapcsolót.
Kell, hogy a MacWhisper nyitva legyen az mw használatához?
A futó alkalmazással beszél, és automatikusan elindítja a MacWhispert, ha az nincs megnyitva.