CLI MacWhisper: memasang mw, mentranskripsikan dari Terminal, dan semua flag-nya
Oleh Ryleigh Newman · Diterbitkan
MacWhisper dilengkapi alat baris perintah bernama mw. Alat ini mengendalikan app dari Terminal: mentranskripsikan file dan seluruh folder, mendeteksi pembicara, menulis subtitle atau JSON, serta menampilkan dan mengganti model. Alat ini berkomunikasi dengan app MacWhisper yang sedang berjalan lewat socket lokal, jadi ia memakai mesin, model, dan pengaturan yang sudah Anda siapkan, dan ia membuka app jika belum terbuka.
Saya mengembangkan YapToText, app Mac lain untuk dikte dan transkripsi file, jadi bacalah apa yang saya tulis tentang MacWhisper dengan mengingat hal itu. Semua fakta tentang MacWhisper di sini berasal dari artikel bantuannya, MacWhisper Command-Line Tool, dibaca pada 10 Oktober 2026.
Gratis diunduh. Tanpa akun dan tanpa fitur terkunci, untuk macOS 14 atau lebih baru di Mac dengan chip Apple. Kode sumber di GitHub.
Panduan ini dalam bahasa lain: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Memasang mw
- Buka MacWhisper, lalu Settings (pengaturan), lalu Advanced.
- Di bawah Command-Line Tool, klik Install.
- Masukkan kata sandi Mac Anda jika macOS memintanya. Kata sandi itu diperlukan untuk menulis ke /usr/local/bin.
- Buka jendela Terminal baru, lalu jalankan mw version.
Alat ini berada di /usr/local/bin/mw, dan panel pengaturan menampilkan tanda centang hijau setelah selesai. Jika mw version menampilkan nomor versi, berarti alat ini berfungsi. Untuk menghapusnya, kembali ke panel yang sama dan klik Uninstall.
Mentranskripsikan satu file
mw transcribe ~/Desktop/meeting.m4a
mw transcribe meeting.m4a > transcript.txt
mw transcribe meeting.m4a -o transcript.txt
mw transcribe meeting.m4a | pbcopyYang terjadi: Transkrip ditampilkan di standard output. Baris progres dikirim ke standard error, sehingga file hasil pengalihan hanya berisi transkrip.
Secara default, transkripsi lewat baris perintah tidak disimpan. Hasilnya ditampilkan lalu dibuang, dan baru muncul di riwayat MacWhisper jika Anda menambahkan --persist. Ctrl+C menghentikan proses. File keluaran yang sudah ada tidak pernah diganti kecuali Anda menambahkan --overwrite.
Daftar perintah
Dari artikel bantuan MacWhisper, dibaca pada 10 Oktober 2026. Tambahkan --help pada perintah apa pun untuk melihat opsinya.
| Perintah | Fungsinya |
|---|---|
| mw | Ringkasan status: apakah app dapat dijangkau, model yang dipilih, model yang sudah diunduh, dan contoh perintah |
| mw version | Menampilkan versi MacWhisper. Berguna untuk memeriksa koneksi |
| mw models list | Menampilkan model transkripsi yang terpasang, lengkap dengan ID masing-masing |
| mw models select | Mengganti model yang aktif, di alat baris perintah maupun di app |
| mw transcribe | Mentranskripsikan file audio atau video, atau seluruh folder, lalu menampilkan teksnya |
Flag untuk mw transcribe
Dari artikel yang sama. Bahasa yang tidak dapat ditranskripsikan oleh model yang dipilih akan menimbulkan error.
| Flag | Fungsinya |
|---|---|
| --speakers, --no-speakers | Menyalakan atau mematikan deteksi pembicara untuk proses ini. Jika menyala, transkrip dikelompokkan menurut pembicara |
| --format | txt sebagai default, atau srt, vtt, json, csv, md, html, atau avid |
| --style | transcript, subtitles, atau segments, gaya yang sama dengan panel ekspor di app |
| --model | Memakai satu model untuk proses ini tanpa mengubah pilihan di app |
| --language | Kode ISO seperti en atau de, atau auto, atau multilingual |
| --output, -o | Menulis transkrip ke sebuah file |
| --output-dir | Mode batch. Menulis satu transkrip untuk setiap input ke dalam folder |
| --recursive | Menyertakan subfolder saat Anda memberikan sebuah folder |
| --stream | Menampilkan segmen begitu selesai. Hanya untuk mesin lokal |
| --persist | Menyimpan transkripsi di riwayat MacWhisper |
| --timestamps, --milliseconds, --group, --max-chars-per-line, --fps | Menyesuaikan tata letak |
Format, dan mana yang memerlukan Pro
Dari artikel yang sama. Halaman harga MacWhisper menjelaskan berapa biaya Pro.
| Format | Yang Anda dapatkan | Lisensi |
|---|---|---|
| txt | Teks biasa | Semua pengguna |
| srt | Subtitle SubRip | Semua pengguna |
| vtt | Subtitle WebVTT | Semua pengguna |
| csv | Baris berisi awal, akhir, dan transkrip, ditambah pembicara jika terdeteksi | Semua pengguna |
| json | Stempel waktu dalam milidetik, pembicara per segmen, dan waktu per kata | Pro |
| md | Markdown dengan blok berstempel waktu dan judul pembicara | Pro |
| html | Dokumen HTML mandiri | Pro |
| avid | Teks subtitle Avid dengan timecode SMPTE | Pro |
Seluruh folder
mw transcribe ~/Recordings --recursive --output-dir ~/Transcripts
mw transcribe ~/Videos --output-dir ~/Subs --format srt
mw transcribe interview.m4a --speakers -o interview.txtYang terjadi: Setiap input mendapat file sendiri dengan nama yang sama, dan struktur folder ditiru. File yang gagal dilaporkan lalu dilewati, dan prosesnya berlanjut.
Deteksi pembicara memerlukan model yang mendukungnya. Halaman pengenalan pembicara membahas sisi app yang itu.
Jika tidak berfungsi
- mw: command not found. Buka jendela Terminal baru, atau tambahkan /usr/local/bin ke PATH Anda.
- Prosesnya macet. Keluar dari MacWhisper lalu buka lagi, kemudian coba mw version.
- ID model tidak dikenali. Jalankan mw models list untuk melihat ID yang tepat, dan unduh modelnya di app terlebih dahulu.
- Error Pro pada sebuah format. json, md, html, dan avid memerlukan lisensi Pro.
- Error sandbox. Program yang berjalan dalam sandbox, termasuk beberapa alat pemrograman AI, dapat diblokir dari socket MacWhisper. Jalankan mw langsung di Terminal.
Halaman pemecahan masalah MacWhisper membahas app-nya sendiri.
Cara gratis dari Terminal
YapToText tidak punya alat baris perintah. App ini mentranskripsikan satu file yang Anda jatuhkan ke dalamnya, satu per satu, menjadi teks biasa, gratis. Jika Anda ingin memakai Terminal tanpa membeli apa pun, whisper.cpp bersifat sumber terbuka dan merupakan mesin yang mendasari YapToText. Panduan Whisper lokal berisi perintahnya, dan halaman perangkat lunak transkripsi sumber terbuka membandingkan empat alat gratis.
Gratis diunduh. Tanpa akun dan tanpa fitur terkunci, untuk macOS 14 atau lebih baru di Mac dengan chip Apple. Kode sumber di GitHub.
Versi singkat
- Pasang. Settings, Advanced, Command-Line Tool, Install.
- Jalankan. mw transcribe, lalu sebuah file atau folder.
- Format gratis. txt, srt, vtt, dan csv.
- Format Pro. json, md, html, dan avid.
- Riwayat. Tidak ada yang disimpan kecuali Anda menambahkan --persist.
Jika MacWhisper mengubah alat ini dan halaman ini tertinggal, buka issue di GitHub. Saya membaca semuanya.
Gratis diunduh. Tanpa akun dan tanpa fitur terkunci, untuk macOS 14 atau lebih baru di Mac dengan chip Apple. Kode sumber di GitHub.
Panduan
Panduan lain, dalam bahasa Inggris
Sumber
- https://docs.macwhisper.com/article/57-macwhisper-command-line-tool (diperiksa 10/10/2026)
- https://github.com/ryleighnewman/YapToText (diperiksa 10/10/2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (diperiksa 10/10/2026)
Pertanyaan
Apakah MacWhisper punya alat baris perintah?
Ya. Namanya mw, dan Anda memasangnya dari Settings MacWhisper, di bawah Advanced, Command-Line Tool.
Bagaimana cara mentranskripsikan file dengan MacWhisper dari Terminal?
Jalankan mw transcribe diikuti jalur file. Transkrip ditampilkan di standard output, atau ditulis ke file dengan -o.
Apakah CLI MacWhisper gratis?
Artikel bantuannya menyatakan keluaran txt, srt, vtt, dan csv tersedia untuk semua pengguna, sedangkan json, md, html, dan avid memerlukan lisensi Pro.
Bisakah CLI MacWhisper mentranskripsikan seluruh folder?
Bisa. Berikan folder ke mw transcribe, tambahkan --recursive untuk subfolder, dan --output-dir untuk menulis satu transkrip per file.
Apakah mw memerlukan MacWhisper dalam keadaan terbuka?
Alat ini berkomunikasi dengan app yang sedang berjalan, dan membuka MacWhisper secara otomatis jika belum terbuka.