أداة MacWhisper CLI: كيف تثبّت mw وتفرّغ من Terminal وكل خياراتها

بقلم · نُشر في

يأتي MacWhisper مع أداة سطر أوامر اسمها mw. تتحكم في التطبيق من Terminal: تفرّغ ملفات ومجلدات كاملة، وتكشف المتحدثين، وتكتب ترجمات مصاحبة أو ملفات JSON، وتسرد النماذج أو تبدّل بينها. تتحدث إلى تطبيق MacWhisper العامل عبر مقبس محلي (local socket)، فتستخدم المحركات والنماذج والإعدادات التي ضبطتها أصلًا، وتشغّل التطبيق إن لم يكن مفتوحًا.

أطوّر 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

ما الذي يحدث: يُطبع النص المفرّغ في المخرج القياسي (standard output). أما سطر التقدم فيذهب إلى خرج الأخطاء القياسي، ولذلك لا يحتوي الملف المعاد توجيهه إلا على النص المفرّغ.

افتراضيًا لا يُحفظ التفريغ الذي يجري من سطر الأوامر. يُطبع ثم يُتخلص منه، ولا يظهر في سجل MacWhisper إلا إذا أضفت --persist. الاختصار Ctrl+C يوقف التشغيل. ولا يُستبدل ملف إخراج موجود أبدًا إلا إذا أضفت --overwrite.

الأوامر

من مقالة المساعدة في MacWhisper، وقد قُرئت في 10 أكتوبر 2026. أضف --help إلى أي أمر لتعرف خياراته.

الأمرما يفعله
mwنظرة عامة على الحالة: هل التطبيق متاح، والنموذج المحدد، والنماذج التي نُزّلت، وأمثلة على الأوامر
mw versionيطبع إصدار MacWhisper. مفيد للتحقق من الاتصال
mw models listيسرد نماذج التفريغ المثبتة لديك، مع معرّف (ID) لكل نموذج
mw models selectيغيّر النموذج النشط، في أداة سطر الأوامر وفي التطبيق
mw transcribeيفرّغ ملفات صوتية أو ملفات فيديو أو مجلدات كاملة، ويطبع النص

خيارات mw transcribe

من المقالة نفسها. اللغة التي لا يستطيع النموذج المختار تفريغها تنتهي بخطأ.

الخيارما يفعله
--speakers, --no-speakersيشغّل كشف المتحدثين أو يوقفه في هذا التشغيل. وعند تشغيله يُجمَّع النص حسب المتحدث
--formattxt وهو الافتراضي، أو srt أو vtt أو json أو csv أو md أو html أو avid
--styletranscript أو subtitles أو segments، وهي الأنماط نفسها الموجودة في لوحة Export في التطبيق
--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). قد يُمنع برنامج يعمل في وضع الحماية، ومنه بعض أدوات البرمجة بالذكاء الاصطناعي، من الوصول إلى مقبس 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.

هل MacWhisper CLI مجانية؟

تقول مقالة المساعدة إن مخرجات txt وsrt وvtt وcsv متاحة للجميع، وإن json وmd وhtml وavid تحتاج إلى ترخيص Pro.

هل تستطيع MacWhisper CLI تفريغ مجلد كامل؟

نعم. مرّر مجلدًا إلى mw transcribe، وأضف --recursive للمجلدات الفرعية، و--output-dir لكتابة نص مفرّغ لكل ملف.

هل يلزم أن يكون MacWhisper مفتوحًا ليعمل mw؟

تتحدث الأداة إلى التطبيق العامل، وتشغّل MacWhisper تلقائيًا إن لم يكن مفتوحًا.