ה-CLI של MacWhisper: להתקין את mw, לתמלל מ-Terminal ולהכיר כל דגל

מאת · פורסם

MacWhisper מגיעה עם כלי שורת פקודה בשם mw. הוא מפעיל את האפליקציה מ-Terminal: מתמללים קבצים ותיקיות שלמות, מזהים דוברים, כותבים כתוביות או JSON, ומציגים מודלים או מחליפים אותם. הכלי מתקשר עם אפליקציית MacWhisper הפועלת דרך שקע מקומי, ולכן הוא משתמש במנועים, במודלים ובהגדרות שכבר הוגדרו, ומפעיל את האפליקציה אם היא אינה פתוחה.

YapToText, אפליקציית Mac אחרת להכתבה ולתמלול קבצים, היא פרי פיתוח שלי, ולכן כדאי לקרוא את דבריי על MacWhisper מתוך ידיעה זו. כל עובדה על MacWhisper כאן לקוחה ממאמר העזרה שלה MacWhisper Command-Line Tool, שנקרא ב-10 באוקטובר 2026.

הורדת YapToText מה-Mac App Storeההורדה בחינם. בלי חשבון ובלי מאפיינים נעולים, ל-macOS 14 ומעלה ב-Mac עם שבב Apple. קוד המקור ב-GitHub.

המדריך הזה בשפות נוספות: English, العربية, Čeština, 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, 简体中文, 繁體中文

התקנת mw

  1. פותחים את MacWhisper, ואז Settings (הגדרות), ואז Advanced (מתקדם).
  2. תחת Command-Line Tool (כלי שורת פקודה) לוחצים על Install (התקנה).
  3. מזינים את סיסמת ה-Mac אם macOS מבקש. היא נחוצה כדי לכתוב אל /usr/local/bin.
  4. פותחים חלון Terminal חדש ומריצים mw version.

הכלי נוחת ב-/usr/local/bin/mw, ובחלונית ההגדרות מופיע סימן וי ירוק בסיום. אם mw version מדפיס מספר גרסה, הכול עובד. כדי להסיר אותו, חוזרים לאותה חלונית ולוחצים על Uninstall (הסרת התקנה).

תמלול קובץ

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

מה קורה: התמלול מודפס לפלט הסטנדרטי. שורת ההתקדמות נשלחת לפלט השגיאות הסטנדרטי, ולכן קובץ שאליו הופנה הפלט מכיל רק את התמלול.

כברירת מחדל, תמלול משורת הפקודה אינו נשמר. הוא מודפס ונמחק, ומופיע בהיסטוריה של MacWhisper רק אם מוסיפים --persist. הצירוף Ctrl+C עוצר הרצה. קובץ פלט קיים אינו מוחלף לעולם, אלא אם מוסיפים --overwrite.

הפקודות

מתוך מאמר העזרה של MacWhisper, שנקרא ב-10 באוקטובר 2026. מוסיפים --help לכל פקודה כדי לראות את האפשרויות שלה.

פקודהמה היא עושה
mwסקירת מצב: האם האפליקציה זמינה, המודל שנבחר, המודלים שהורדו ופקודות לדוגמה
mw versionמדפיסה את גרסת MacWhisper. שימושית כבדיקת חיבור
mw models listמציגה את מודלי התמלול שהותקנו, עם מזהה לכל מודל
mw models selectמשנה את המודל הפעיל, בכלי שורת הפקודה ובאפליקציה
mw transcribeמתמללת קובצי שמע או וידאו, או תיקיות שלמות, ומדפיסה את המלל

דגלים של mw transcribe

מאותו מאמר. שפה שהמודל שנבחר אינו יכול לתמלל גורמת לשגיאה.

דגלמה הוא עושה
--speakers, --no-speakersמפעיל או מכבה זיהוי דוברים בהרצה הזו. כשהוא מופעל, התמלול מקובץ לפי דוברים
--formattxt, ברירת המחדל, או srt, vtt, json, csv, md, html או avid
--styletranscript, subtitles או segments, אותם סגנונות שיש בחלונית הייצוא של האפליקציה
--modelמשתמש במודל אחד בהרצה הזו בלי לשנות את הבחירה באפליקציה
--languageקוד ISO כמו en או de, או auto, או multilingual
--output, -oכותב את התמלול לקובץ
--output-dirמצב אצווה. כותב תמלול אחד לכל קלט בתוך תיקייה
--recursiveכולל תיקיות משנה כשמעבירים תיקייה
--streamמדפיס מקטעים כשהם מוכנים. במנועים מקומיים בלבד
--persistשומר את התמלול בהיסטוריה של MacWhisper
--timestamps, --milliseconds, --group, --max-chars-per-line, --fpsכוונון עדין של הפריסה

פורמטים, ואילו מהם דורשים Pro

מאותו מאמר. עמוד המחירים של MacWhisper מסביר כמה עולה Pro.

פורמטמה מקבליםרישיון
txtמלל פשוטכולם
srtכתוביות SubRipכולם
vttכתוביות WebVTTכולם
csvשורות של התחלה, סיום ותמלול, ובנוסף דובר כשזוההכולם
jsonחותמות זמן באלפיות שנייה, דוברים בכל מקטע וזמנים של מיליםPro
mdMarkdown עם בלוקים מתוארכים וכותרות דובריםPro
htmlמסמך HTML עצמאיPro
avidמלל כתוביות של Avid עם קודי זמן SMPTEPro

תיקיות שלמות

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

מה קורה: כל קלט מקבל קובץ משלו, על שמו, ומבנה התיקיות משוחזר. קובץ שנכשל מדווח ומדולג, וההרצה נמשכת.

זיהוי דוברים דורש מודל שתומך בכך. העמוד על זיהוי דוברים עוסק בצד הזה של האפליקציה.

כשזה לא עובד

  • mw: command not found. פותחים חלון Terminal חדש, או מוסיפים את /usr/local/bin ל-PATH.
  • הכלי נתקע. סוגרים את MacWhisper ופותחים אותה מחדש, ואז מנסים mw version.
  • מזהה מודל לא מזוהה. מריצים mw models list כדי לראות את המזהים המדויקים, ומורידים קודם את המודל באפליקציה.
  • שגיאת Pro בפורמט. הפורמטים json, md, html ו-avid דורשים רישיון Pro.
  • שגיאת sandbox. תוכנה שרצה בתוך sandbox, כולל כלי תכנות מסוימים מבוססי בינה מלאכותית, עלולה להיחסם מול השקע של MacWhisper. מריצים את mw ישירות ב-Terminal.

עמוד פתרון הבעיות של MacWhisper עוסק באפליקציה עצמה.

דרכים חינמיות מ-Terminal

ל-YapToText אין כלי שורת פקודה. היא מתמללת קובץ שגוררים אליה, אחד בכל פעם, למלל פשוט, בחינם. מי שרוצה Terminal ולא רוצה לקנות דבר יכול להשתמש ב-whisper.cpp, שהוא קוד פתוח והמנוע ש-YapToText בנויה עליו. המדריך ל-Whisper מקומי כולל את הפקודות, והעמוד על תוכנות תמלול בקוד פתוח משווה בין ארבעה כלים חינמיים.

הורדת YapToText מה-Mac App Storeההורדה בחינם. בלי חשבון ובלי מאפיינים נעולים, ל-macOS 14 ומעלה ב-Mac עם שבב Apple. קוד המקור ב-GitHub.

בקצרה

  • התקנה. Settings, Advanced, Command-Line Tool, Install.
  • הרצה. mw transcribe, ואחריה קובץ או תיקייה.
  • פורמטים חינמיים. txt, srt, vtt ו-csv.
  • פורמטים של Pro. json, md, html ו-avid.
  • היסטוריה. דבר אינו נשמר אלא אם מוסיפים --persist.

אם MacWhisper משנה את הכלי והעמוד הזה מפגר, אפשר לפתוח issue ב-GitHub. כל פנייה נקראת.

הורדת YapToText מה-Mac App Storeההורדה בחינם. בלי חשבון ובלי מאפיינים נעולים, ל-macOS 14 ומעלה ב-Mac עם שבב Apple. קוד המקור ב-GitHub.

מי כותב כאן. שמי Ryleigh Newman. פיתוח תוכנה הוא העיסוק שלי, קשה לי להקליד, ובכל יום ההכתבה שלי נעשית ב-YapToText, האפליקציה שהאתר הזה מתאר. העמוד הזה תורגם מאנגלית. הממשק של האפליקציה ושאר עמודי האתר הם באנגלית. עוד על הפרויקט, באנגלית.

מדריכים

מדריכים נוספים, באנגלית

מקורות

שאלות

האם ל-MacWhisper יש כלי שורת פקודה?

כן. קוראים לו mw, ומתקינים אותו מההגדרות של MacWhisper, תחת Advanced ואז Command-Line Tool.

איך מתמללים קובץ עם MacWhisper מ-Terminal?

מריצים mw transcribe ואחריו נתיב הקובץ. התמלול מודפס לפלט הסטנדרטי, או לקובץ אם מוסיפים -o.

האם ה-CLI של MacWhisper חינמי?

לפי מאמר העזרה שלה, פלט txt, srt, vtt ו-csv זמין לכולם, ואילו json, md, html ו-avid דורשים רישיון Pro.

האם ה-CLI של MacWhisper יכול לתמלל תיקייה שלמה?

כן. מעבירים תיקייה אל mw transcribe, מוסיפים --recursive לתיקיות משנה ואת --output-dir כדי לכתוב תמלול אחד לכל קובץ.

האם mw דורש ש-MacWhisper תהיה פתוחה?

הוא מתקשר עם האפליקציה הפועלת, ומפעיל את MacWhisper אוטומטית אם היא אינה פתוחה.