MacWhisper CLI: cài mw, chép lời từ Terminal và mọi tùy chọn của lệnh
Bài viết: Ryleigh Newman · Đăng ngày
MacWhisper đi kèm một công cụ dòng lệnh tên là mw. Nó điều khiển ứng dụng từ Terminal: chép lời tệp và cả thư mục, nhận dạng người nói, ghi phụ đề hoặc JSON, liệt kê và đổi mô hình. Nó trao đổi với ứng dụng MacWhisper đang chạy qua một socket cục bộ, nên dùng đúng các công cụ nhận dạng, mô hình và cài đặt bạn đã thiết lập, và tự mở ứng dụng nếu ứng dụng chưa mở.
Tôi làm ra YapToText, một ứng dụng Mac khác dành cho đọc chính tả và chép lời tệp, nên hãy đọc những gì tôi nói về MacWhisper với điều đó trong đầu. Mọi thông tin về MacWhisper ở đây lấy từ bài trợ giúp MacWhisper Command-Line Tool của nó, đọc vào ngày 10 tháng 10 năm 2026.
Tải về miễn phí. Không cần tài khoản, không có tính năng bị khóa, dành cho macOS 14 trở lên trên máy Mac có chip Apple. Mã nguồn trên GitHub.
Hướng dẫn này bằng ngôn ngữ khác: 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, Українська, 简体中文, 繁體中文
Trong trang này: 13 phần
Cài mw
- Mở MacWhisper, rồi vào Settings (Cài đặt), rồi Advanced (Nâng cao).
- Ở mục Command-Line Tool (công cụ dòng lệnh), bấm Install (Cài đặt).
- Nhập mật khẩu máy Mac nếu macOS yêu cầu. Mật khẩu cần để ghi vào /usr/local/bin.
- Mở một cửa sổ Terminal mới và chạy mw version.
Công cụ được đặt tại /usr/local/bin/mw, và ngăn cài đặt hiện dấu kiểm màu xanh khi xong. Nếu mw version in ra một số phiên bản thì công cụ đã chạy. Để gỡ, quay lại đúng ngăn đó và bấm Uninstall (Gỡ cài đặt).
Chép lời một tệp
mw transcribe ~/Desktop/meeting.m4a
mw transcribe meeting.m4a > transcript.txt
mw transcribe meeting.m4a -o transcript.txt
mw transcribe meeting.m4a | pbcopyĐiều xảy ra: Bản chép lời được in ra đầu ra chuẩn. Dòng tiến độ đi vào đầu ra lỗi chuẩn, nên tệp được chuyển hướng chỉ chứa bản chép lời.
Mặc định, một lần chép lời bằng dòng lệnh không được lưu lại. Nó được in ra rồi bỏ đi, và chỉ xuất hiện trong lịch sử của MacWhisper nếu bạn thêm --persist. Ctrl+C dừng một lần chạy. Tệp đầu ra đã có sẽ không bao giờ bị thay thế trừ khi bạn thêm --overwrite.
Các lệnh
Theo bài trợ giúp của MacWhisper, đọc ngày 10 tháng 10 năm 2026. Thêm --help vào bất kỳ lệnh nào để xem các tùy chọn của nó.
| Lệnh | Chức năng |
|---|---|
| mw | Tổng quan trạng thái: ứng dụng có kết nối được không, mô hình đang chọn, các mô hình đã tải, và lệnh ví dụ |
| mw version | In ra phiên bản MacWhisper. Hữu ích để kiểm tra kết nối |
| mw models list | Liệt kê các mô hình chép lời đã cài, kèm một ID cho mỗi mô hình |
| mw models select | Đổi mô hình đang dùng, cả trong công cụ dòng lệnh và trong ứng dụng |
| mw transcribe | Chép lời các tệp âm thanh hoặc video, hoặc cả thư mục, và in ra văn bản |
Các tùy chọn của mw transcribe
Theo cùng bài viết đó. Nếu chọn một ngôn ngữ mà mô hình đang dùng không chép lời được thì lệnh báo lỗi.
| Tùy chọn | Chức năng |
|---|---|
| --speakers, --no-speakers | Bật hoặc tắt nhận dạng người nói cho lần chạy này. Khi bật, bản chép lời được nhóm theo người nói |
| --format | txt là mặc định, hoặc srt, vtt, json, csv, md, html hay avid |
| --style | transcript, subtitles hoặc segments, cùng các kiểu như bảng Export của ứng dụng |
| --model | Dùng một mô hình cho lần chạy này mà không đổi lựa chọn trong ứng dụng |
| --language | Một mã ISO như en hoặc de, hoặc auto, hoặc multilingual |
| --output, -o | Ghi bản chép lời vào một tệp |
| --output-dir | Chế độ hàng loạt. Ghi mỗi đầu vào thành một bản chép lời trong một thư mục |
| --recursive | Bao gồm cả thư mục con khi bạn đưa vào một thư mục |
| --stream | In từng đoạn ngay khi xong. Chỉ với công cụ nhận dạng chạy trên máy |
| --persist | Giữ bản chép lời trong lịch sử của MacWhisper |
| --timestamps, --milliseconds, --group, --max-chars-per-line, --fps | Tinh chỉnh bố cục |
Các định dạng, và định dạng nào cần Pro
Theo cùng bài viết đó. Trang giá MacWhisper nói về chi phí của Pro.
| Định dạng | Bạn nhận được | Giấy phép |
|---|---|---|
| txt | Văn bản thuần | Mọi người |
| srt | Phụ đề SubRip | Mọi người |
| vtt | Phụ đề WebVTT | Mọi người |
| csv | Các hàng gồm bắt đầu, kết thúc và bản chép lời, thêm người nói khi nhận dạng được | Mọi người |
| json | Dấu thời gian theo mili giây, người nói theo từng đoạn, và thời điểm từng từ | Pro |
| md | Markdown với các khối có dấu thời gian và tiêu đề người nói | Pro |
| html | Một tài liệu HTML độc lập | Pro |
| avid | Văn bản phụ đề Avid với mã thời gian SMPTE | Pro |
Cả thư mục
mw transcribe ~/Recordings --recursive --output-dir ~/Transcripts
mw transcribe ~/Videos --output-dir ~/Subs --format srt
mw transcribe interview.m4a --speakers -o interview.txtĐiều xảy ra: Mỗi đầu vào có một tệp riêng, đặt tên theo nó, và cấu trúc thư mục được giữ nguyên. Tệp nào bị lỗi sẽ được báo và bỏ qua, còn lần chạy vẫn tiếp tục.
Nhận dạng người nói cần một mô hình hỗ trợ việc đó. Trang nhận dạng người nói nói về phần này của ứng dụng.
Khi nó không hoạt động
- mw: command not found. Mở một cửa sổ Terminal mới, hoặc thêm /usr/local/bin vào PATH của bạn.
- Lệnh bị treo. Thoát và mở lại MacWhisper, rồi thử mw version.
- ID mô hình không được nhận. Chạy mw models list để xem đúng các ID, và tải mô hình trong ứng dụng trước.
- Lỗi Pro với một định dạng. json, md, html và avid cần giấy phép Pro.
- Lỗi sandbox. Một chương trình chạy trong sandbox, kể cả một số công cụ lập trình bằng AI, có thể bị chặn không vào được socket của MacWhisper. Hãy chạy mw trực tiếp trong Terminal.
Trang khắc phục sự cố MacWhisper nói về chính ứng dụng.
Cách miễn phí từ Terminal
YapToText không có công cụ dòng lệnh. Nó chép lời một tệp bạn thả vào, từng tệp một, ra văn bản thuần, miễn phí. Nếu bạn muốn dùng Terminal mà không phải mua gì, whisper.cpp là mã nguồn mở và là công cụ nhận dạng mà YapToText được xây dựng trên đó. Hướng dẫn Whisper chạy trên máy có các lệnh, và trang phần mềm chép lời mã nguồn mở so sánh bốn công cụ miễn phí.
Tải về miễn phí. Không cần tài khoản, không có tính năng bị khóa, dành cho macOS 14 trở lên trên máy Mac có chip Apple. Mã nguồn trên GitHub.
Tóm tắt ngắn
- Cài. Settings, Advanced, Command-Line Tool, Install.
- Chạy. mw transcribe, rồi một tệp hoặc một thư mục.
- Định dạng miễn phí. txt, srt, vtt và csv.
- Định dạng Pro. json, md, html và avid.
- Lịch sử. Không có gì được lưu trừ khi bạn thêm --persist.
Nếu MacWhisper thay đổi công cụ này và trang này lỗi thời, hãy mở một issue trên GitHub. Tôi đọc tất cả.
Tải về miễn phí. Không cần tài khoản, không có tính năng bị khóa, dành cho macOS 14 trở lên trên máy Mac có chip Apple. Mã nguồn trên GitHub.
Hướng dẫn
Hướng dẫn khác, bằng tiếng Anh
Nguồn
- https://docs.macwhisper.com/article/57-macwhisper-command-line-tool (kiểm tra ngày 10/10/2026)
- https://github.com/ryleighnewman/YapToText (kiểm tra ngày 10/10/2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (kiểm tra ngày 10/10/2026)
Câu hỏi
MacWhisper có công cụ dòng lệnh không?
Có. Nó tên là mw, và bạn cài từ Settings của MacWhisper, trong Advanced, Command-Line Tool.
Làm sao chép lời một tệp bằng MacWhisper từ Terminal?
Chạy mw transcribe rồi đến đường dẫn tệp. Bản chép lời được in ra đầu ra chuẩn, hoặc vào một tệp nếu dùng -o.
MacWhisper CLI có miễn phí không?
Bài trợ giúp của nó nói đầu ra txt, srt, vtt và csv dành cho mọi người, còn json, md, html và avid cần giấy phép Pro.
MacWhisper CLI có chép lời được cả thư mục không?
Có. Đưa một thư mục vào mw transcribe, thêm --recursive để lấy cả thư mục con, và --output-dir để ghi một bản chép lời cho mỗi tệp.
mw có cần MacWhisper đang mở không?
Nó trao đổi với ứng dụng đang chạy, và tự động mở MacWhisper nếu ứng dụng chưa mở.