MacWhisper CLI: ติดตั้ง mw ถอดเสียงจาก Terminal และตัวเลือกทุกตัว

เขียนโดย Ryleigh Newman · เผยแพร่ 10/10/2026

MacWhisper มาพร้อมเครื่องมือบรรทัดคำสั่งชื่อ mw ใช้ควบคุมแอปจาก Terminal ได้ ถอดเสียงไฟล์และทั้งโฟลเดอร์ ตรวจจับผู้พูด เขียนคำบรรยายหรือ JSON และแสดงรายการหรือสลับโมเดล เครื่องมือนี้คุยกับแอป MacWhisper ที่เปิดอยู่ผ่านซ็อกเก็ตในเครื่อง จึงใช้เอนจิน โมเดล และการตั้งค่าที่คุณตั้งไว้แล้ว และจะเปิดแอปให้ถ้าแอปยังไม่ได้เปิด

ฉันพัฒนา YapToText ซึ่งเป็นแอป Mac อีกตัวสำหรับการป้อนตามคำบอกและการถอดเสียงไฟล์ โปรดคำนึงถึงข้อนี้เมื่ออ่านสิ่งที่ฉันพูดถึง MacWhisper ข้อเท็จจริงทุกข้อเกี่ยวกับ MacWhisper ในหน้านี้มาจากบทความช่วยเหลือ MacWhisper Command-Line Tool ซึ่งอ่านเมื่อวันที่ 10 ตุลาคม 2026

ดาวน์โหลดฟรี ไม่ต้องมีบัญชีและไม่มีคุณสมบัติที่ถูกล็อค สำหรับ 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

เปิด MacWhisper แล้วไปที่ Settings (การตั้งค่า) จากนั้นไปที่ Advanced (ขั้นสูง)
ใต้ Command-Line Tool (เครื่องมือบรรทัดคำสั่ง) คลิก Install (ติดตั้ง)
ป้อนรหัสผ่าน Mac ของคุณถ้า macOS ถาม เพราะต้องใช้รหัสผ่านเพื่อเขียนลงใน /usr/local/bin
เปิดหน้าต่าง 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	แสดงรายการโมเดลถอดเสียงที่ติดตั้งแล้ว พร้อม ID ของแต่ละโมเดล
mw models select	เปลี่ยนโมเดลที่ใช้งานอยู่ ทั้งในเครื่องมือบรรทัดคำสั่งและในแอป
mw transcribe	ถอดเสียงไฟล์เสียงหรือวิดีโอ หรือทั้งโฟลเดอร์ แล้วแสดงข้อความ

ตัวเลือกของ mw transcribe

จากบทความเดียวกัน ถ้าภาษาที่ระบุเป็นภาษาที่โมเดลที่เลือกถอดเสียงไม่ได้ จะเกิดข้อผิดพลาด

ตัวเลือก	ทำอะไร
--speakers, --no-speakers	เปิดหรือปิดการตรวจจับผู้พูดสำหรับการรันครั้งนี้ เมื่อเปิด ข้อความถอดเสียงจะถูกจัดกลุ่มตามผู้พูด
--format	txt ซึ่งเป็นค่าเริ่มต้น หรือ srt, vtt, json, csv, md, html หรือ avid
--style	transcript, 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
md	Markdown ที่มีบล็อกพร้อมการประทับเวลา และหัวข้อตามผู้พูด	Pro
html	เอกสาร HTML แบบสแตนด์อโลน	Pro
avid	ข้อความคำบรรยายของ Avid พร้อมไทม์โค้ด SMPTE	Pro

ทั้งโฟลเดอร์

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
ไม่รู้จัก ID ของโมเดล. รัน mw models list เพื่อดู ID ที่ถูกต้อง และดาวน์โหลดโมเดลในแอปก่อน
ข้อผิดพลาดเรื่อง Pro กับรูปแบบไฟล์. json, md, html และ avid ต้องมีใบอนุญาต Pro
ข้อผิดพลาดแซนด์บอกซ์. โปรแกรมที่รันในแซนด์บอกซ์ รวมถึงเครื่องมือเขียนโค้ดด้วย AI บางตัว อาจถูกบล็อกไม่ให้เข้าถึงซ็อกเก็ตของ MacWhisper ให้รัน mw โดยตรงใน Terminal

หน้าแก้ปัญหา MacWhisper อธิบายเรื่องตัวแอปเอง

ทางเลือกฟรีจาก Terminal

YapToText ไม่มีเครื่องมือบรรทัดคำสั่ง แอปถอดเสียงไฟล์ที่คุณวางลงบนแอปทีละไฟล์เป็นข้อความธรรมดา และฟรี ถ้าคุณต้องการใช้ Terminal โดยไม่ต้องซื้ออะไร whisper.cpp เป็นโอเพนซอร์ส และเป็นเอนจินที่ YapToText สร้างขึ้นบนนั้น คู่มือ Whisper ในเครื่อง มีคำสั่งให้ และ หน้าซอฟต์แวร์ถอดเสียงโอเพนซอร์ส เปรียบเทียบเครื่องมือฟรีสี่ตัว

สรุปสั้น ๆ

ติดตั้ง. Settings, Advanced, Command-Line Tool, Install
รัน. mw transcribe ตามด้วยไฟล์หรือโฟลเดอร์
รูปแบบฟรี. txt, srt, vtt และ csv
รูปแบบ Pro. json, md, html และ avid
ประวัติ. จะไม่มีอะไรถูกเก็บไว้ ถ้าคุณไม่เพิ่ม --persist

ถ้า MacWhisper เปลี่ยนเครื่องมือนี้และหน้านี้ไม่ทันสมัย เปิด issue บน GitHub ฉันอ่านทุกรายการ

เกี่ยวกับผู้เขียน Ryleigh Newman พัฒนาซอฟต์แวร์ พิมพ์ด้วยมือได้ลำบาก และป้อนตามคำบอกทุกวันด้วย YapToText ซึ่งเป็นแอปที่เว็บไซต์นี้แนะนำ หน้านี้แปลมาจากภาษาอังกฤษ หน้าตาของแอปและหน้าอื่นของเว็บไซต์เป็นภาษาอังกฤษ ดูเพิ่มเติมเกี่ยวกับโครงการนี้ (ภาษาอังกฤษ)

คู่มือ

คู่มืออื่น (ภาษาอังกฤษ)

แหล่งที่มา

https://docs.macwhisper.com/article/57-macwhisper-command-line-tool (ตรวจสอบเมื่อ 10/10/2026)
https://github.com/ryleighnewman/YapToText (ตรวจสอบเมื่อ 10/10/2026)
https://apps.apple.com/us/app/yaptotext/id6786382289 (ตรวจสอบเมื่อ 10/10/2026)

คำถาม

MacWhisper มีเครื่องมือบรรทัดคำสั่งหรือไม่

มี ชื่อ mw และคุณติดตั้งได้จากการตั้งค่าของ MacWhisper ใต้ Advanced แล้วเลือก Command-Line Tool

ถอดเสียงไฟล์ด้วย MacWhisper จาก Terminal ได้อย่างไร

รัน mw transcribe ตามด้วยพาธของไฟล์ ข้อความถอดเสียงจะแสดงในเอาต์พุตมาตรฐาน หรือเขียนลงไฟล์ด้วย -o

MacWhisper CLI ฟรีหรือไม่

บทความช่วยเหลือของ MacWhisper ระบุว่าเอาต์พุต txt, srt, vtt และ csv ใช้ได้กับทุกคน ส่วน json, md, html และ avid ต้องมีใบอนุญาต Pro

MacWhisper CLI ถอดเสียงทั้งโฟลเดอร์ได้หรือไม่

ได้ ระบุโฟลเดอร์ให้ mw transcribe เพิ่ม --recursive สำหรับโฟลเดอร์ย่อย และ --output-dir เพื่อเขียนข้อความถอดเสียงหนึ่งไฟล์ต่อหนึ่งไฟล์ต้นฉบับ

mw ต้องให้ MacWhisper เปิดอยู่หรือไม่

mw คุยกับแอปที่เปิดอยู่ และจะเปิด MacWhisper ให้อัตโนมัติถ้าแอปยังไม่ได้เปิด