MacWhisper CLI: mw aracını kurun, Terminal’den yazıya dökün ve tüm bayrakları öğrenin
Yazan: Ryleigh Newman · Yayımlanma:
MacWhisper, mw adlı bir komut satırı aracıyla birlikte gelir. Uygulamayı Terminal’den yönetir: dosyaları ve tüm klasörleri yazıya döker, konuşmacıları ayırır, altyazı veya JSON yazar, modelleri listeler ve değiştirir. Çalışan MacWhisper uygulamasıyla yerel bir soket üzerinden konuşur, bu yüzden zaten kurduğunuz motorları, modelleri ve ayarları kullanır. Uygulama açık değilse onu kendisi başlatır.
Dikte ve dosya yazıya dökme için başka bir Mac uygulaması olan YapToText’i ben geliştiriyorum, bu yüzden MacWhisper hakkında yazdıklarımı bunu bilerek okuyun. Buradaki her MacWhisper bilgisi, 10 Ekim 2026’da okuduğum MacWhisper Command-Line Tool yardım makalesinden geliyor.
Ücretsiz indirilir. Hesap gerekmez, kilitli özellik yoktur. Apple çipli bir Mac ve macOS 14 veya sonrası gerekir. Kaynak kodu GitHub’da.
Bu rehberin diğer dilleri: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Українська, Tiếng Việt, 简体中文, 繁體中文
mw aracını kurun
- MacWhisper’ı açın, sonra Settings (ayarlar) ve ardından Advanced (gelişmiş) bölümüne gidin.
- Command-Line Tool (komut satırı aracı) altında Install (kur) düğmesine tıklayın.
- macOS sorarsa Mac parolanızı girin. /usr/local/bin içine yazmak için gerekir.
- Yeni bir Terminal penceresi açın ve mw version komutunu çalıştırın.
Araç /usr/local/bin/mw konumuna kurulur ve işlem bittiğinde ayarlar bölmesinde yeşil bir onay işareti görünür. mw version bir sürüm numarası yazdırıyorsa araç çalışıyordur. Kaldırmak için aynı bölmeye dönün ve Uninstall (kaldır) düğmesine tıklayın.
Bir dosyayı yazıya dökün
mw transcribe ~/Desktop/meeting.m4a
mw transcribe meeting.m4a > transcript.txt
mw transcribe meeting.m4a -o transcript.txt
mw transcribe meeting.m4a | pbcopyNe olur: Döküm standart çıktıya yazdırılır. İlerleme satırı standart hataya gider, bu yüzden yönlendirilen dosyada yalnızca döküm olur.
Varsayılan olarak komut satırından yapılan yazıya dökme saklanmaz. Yazdırılır ve atılır, yalnızca --persist eklerseniz MacWhisper’ın geçmişinde görünür. Ctrl+C çalışmayı durdurur. Var olan bir çıktı dosyasının üzerine, --overwrite eklemediğiniz sürece asla yazılmaz.
Komutlar
MacWhisper’ın yardım makalesinden, 10 Ekim 2026’da okundu. Seçeneklerini görmek için herhangi bir komuta --help ekleyin.
| Komut | Ne yapar |
|---|---|
| mw | Durum özeti: uygulamaya ulaşılıp ulaşılamadığı, seçili model, indirilmiş modeller ve örnek komutlar |
| mw version | MacWhisper sürümünü yazdırır. Bağlantı denetimi olarak işe yarar |
| mw models list | Kurulu yazıya dökme modellerinizi, her birinin kimliğiyle listeler |
| mw models select | Etkin modeli hem komut satırı aracında hem uygulamada değiştirir |
| mw transcribe | Ses veya video dosyalarını ya da tüm klasörleri yazıya döker ve metni yazdırır |
mw transcribe bayrakları
Aynı makaleden. Seçilen modelin yazıya dökemediği bir dil hata verir.
| Bayrak | Ne yapar |
|---|---|
| --speakers, --no-speakers | Bu çalışma için konuşmacı algılamayı açar veya kapatır. Açıkken döküm konuşmacıya göre gruplanır |
| --format | txt (varsayılan) veya srt, vtt, json, csv, md, html ya da avid |
| --style | transcript, subtitles veya segments, uygulamanın Export panelindeki stillerle aynı |
| --model | Uygulamadaki seçimi değiştirmeden bu çalışma için tek bir model kullanır |
| --language | en veya de gibi bir ISO kodu, ya da auto veya multilingual |
| --output, -o | Dökümü bir dosyaya yazar |
| --output-dir | Toplu mod. Her girdi için bir klasöre ayrı bir döküm yazar |
| --recursive | Bir klasör verdiğinizde alt klasörleri de kapsar |
| --stream | Segmentleri bittikçe yazdırır. Yalnızca yerel motorlarda çalışır |
| --persist | Yazıya dökmeyi MacWhisper’ın geçmişinde tutar |
| --timestamps, --milliseconds, --group, --max-chars-per-line, --fps | Düzeni ince ayarlar |
Biçimler ve hangileri Pro ister
Aynı makaleden. MacWhisper fiyat sayfası Pro’nun ne kadar tuttuğunu anlatır.
| Biçim | Ne elde edersiniz | Lisans |
|---|---|---|
| txt | Düz metin | Herkes |
| srt | SubRip altyazı | Herkes |
| vtt | WebVTT altyazı | Herkes |
| csv | Başlangıç, bitiş ve döküm satırları, algılandığında konuşmacı da | Herkes |
| json | Milisaniye zaman damgaları, segment başına konuşmacılar ve kelime zamanlamaları | Pro |
| md | Zaman damgalı bloklar ve konuşmacı başlıkları olan Markdown | Pro |
| html | Bağımsız bir HTML belgesi | Pro |
| avid | SMPTE zaman kodlu Avid altyazı metni | Pro |
Tüm klasörler
mw transcribe ~/Recordings --recursive --output-dir ~/Transcripts
mw transcribe ~/Videos --output-dir ~/Subs --format srt
mw transcribe interview.m4a --speakers -o interview.txtNe olur: Her girdi kendi adını taşıyan ayrı bir dosya alır ve klasör yapısı aynen yansıtılır. Başarısız olan dosya bildirilir ve atlanır, çalışma devam eder.
Konuşmacı algılama, bunu destekleyen bir model ister. Konuşmacı tanıma sayfası uygulamanın bu yanını anlatır.
Çalışmadığında
- mw: command not found. Yeni bir Terminal penceresi açın ya da /usr/local/bin dizinini PATH’inize ekleyin.
- Takılıyor. MacWhisper’ı kapatıp yeniden açın, sonra mw version komutunu deneyin.
- Model kimliği tanınmıyor. Tam kimlikler için mw models list komutunu çalıştırın ve modeli önce uygulamada indirin.
- Bir biçimde Pro hatası. json, md, html ve avid için Pro lisansı gerekir.
- Sandbox hatası. Bazı yapay zekâ kodlama araçları dahil, sandbox içinde çalışan bir program MacWhisper’ın soketine erişemeyebilir. mw komutunu doğrudan Terminal’de çalıştırın.
MacWhisper sorun giderme sayfası uygulamanın kendisini ele alır.
Terminal’den ücretsiz yollar
YapToText’in komut satırı aracı yoktur. Üzerine bıraktığınız bir dosyayı, her seferinde birini, ücretsiz olarak düz metne döker. Terminal istiyor ve satın alınacak bir şey istemiyorsanız whisper.cpp açık kaynaklıdır ve YapToText’in dayandığı motordur. Yerel Whisper rehberi komutları içerir, açık kaynak yazıya dökme sayfası ise dört ücretsiz aracı karşılaştırır.
Ücretsiz indirilir. Hesap gerekmez, kilitli özellik yoktur. Apple çipli bir Mac ve macOS 14 veya sonrası gerekir. Kaynak kodu GitHub’da.
Kısaca
- Kurulum. Settings, Advanced, Command-Line Tool, Install yolunu izleyin.
- Çalıştırma. mw transcribe yazın, ardından bir dosya ya da klasör verin.
- Ücretsiz biçimler. txt, srt, vtt ve csv herkese açıktır.
- Pro biçimleri. json, md, html ve avid için Pro gerekir.
- Geçmiş. --persist eklemediğiniz sürece hiçbir şey saklanmaz.
MacWhisper aracı değiştirirse ve bu sayfa geride kalırsa GitHub’da bir issue açın (İngilizce). Hepsini okuyorum.
Ücretsiz indirilir. Hesap gerekmez, kilitli özellik yoktur. Apple çipli bir Mac ve macOS 14 veya sonrası gerekir. Kaynak kodu GitHub’da.
Rehberler
Diğer rehberler, İngilizce
Kaynaklar
- https://docs.macwhisper.com/article/57-macwhisper-command-line-tool (kontrol tarihi 10.10.2026)
- https://github.com/ryleighnewman/YapToText (kontrol tarihi 10.10.2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (kontrol tarihi 10.10.2026)
Sorular
MacWhisper’ın komut satırı aracı var mı?
Evet. Adı mw ve MacWhisper’ın Settings bölümünde, Advanced altında, Command-Line Tool kısmından kuruluyor.
Terminal’den MacWhisper ile bir dosya nasıl yazıya dökülür?
mw transcribe komutunu ve ardından dosya yolunu yazın. Döküm standart çıktıya ya da -o ile bir dosyaya yazdırılır.
MacWhisper CLI ücretsiz mi?
Yardım makalesi, txt, srt, vtt ve csv çıktısının herkese açık olduğunu, json, md, html ve avid için Pro lisansı gerektiğini söylüyor.
MacWhisper CLI tüm bir klasörü yazıya dökebilir mi?
Evet. mw transcribe komutuna bir klasör verin, alt klasörler için --recursive, dosya başına bir döküm yazmak için --output-dir ekleyin.
mw çalışırken MacWhisper’ın açık olması gerekir mi?
Çalışan uygulamayla konuşur ve MacWhisper açık değilse onu kendiliğinden başlatır.