VoiceInk Custom Commands: diktenizi yapıştırmak yerine bir betiğe gönderin
Yazan: Ryleigh Newman · Yayımlanma:
Custom Command (özel komut), VoiceInk’in çıktı modlarından biridir. VoiceInk yapıştırmak yerine bir diktenin bitmiş metnini sizin yazdığınız bir kabuk komutuna verir ve ne olacağına o komut karar verir: bir nota eklemek, arama açmak, kendi betiğinizi çağırmak ya da kendi çalıştırdığınız bir servise göndermek. VoiceInk’in metinle yaptığı en esnek şey budur ve üzerine bir şey kurmadan önce bilmeye değer birkaç kesin sınırı vardır.
Mac için başka bir dikte uygulaması olan YapToText’i ben geliştiriyorum, bu yüzden VoiceInk hakkında yazdıklarımı bunu bilerek okuyun. Buradaki VoiceInk bilgilerinin hepsi 10 Ekim 2026’da okuduğum kendi belgelerinden gelir.
Ü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, 简体中文, 繁體中文
Komut ne alır
VoiceInk aynı son metni iki yoldan gönderir: standart girdi olarak ve $VOICEINK_TRANSCRIPT değişkeninde. Metin UTF-8’dir ve belgeler, boşlukların, noktalamanın ve satır sonlarının korunması için değişkeni tırnak içine almanızı ister.
- AI Enhancement kapalıyken. VoiceInk’in biçimlendirmesinden ve kelime değiştirmelerinden sonraki döküm.
- AI Enhancement açık ve çalışıyorken. İyileştirilmiş metin.
- AI Enhancement atlandığında ya da başarısız olduğunda. Düz son döküm.
Komut ses kaydını, istemi ya da seçili, pano veya ekran metnini doğrudan almaz. Bağlamın sonucu şekillendirmesini istiyorsanız belgeler bir istem ve Context Awareness kullanmanızı söyler, böylece bağlam zaten son metnin içinde olur.
Nasıl çalışır
VoiceInk’in Custom Commands belgelerinden, 10 Ekim 2026’da okunmuştur.
| Ayrıntı | Davranış |
|---|---|
| Kabuk | /bin/zsh -lc |
| Zaman aşımı | 10 saniye, sonra VoiceInk komutu durdurur |
| İzinler | VoiceInk ile aynı macOS kullanıcı izinleri |
| Kaydedici | Komut başlamadan önce kapatılır |
| Başarı | Çıkış kodu 0. Başka her şey başarısızlık sayılır |
| Çıktı | Standart çıktı ve hatalar tanılama için saklanır, uygulamaya hiçbir zaman yapıştırılmaz |
| Bulunamayan komutlar | VoiceInk kabuğunuzun PATH değerini dener. Başarısız olursa /opt/homebrew/bin/tool gibi tam bir yol kullanın |
İnsanları yakalayan sınırlar
- Sizin için hiçbir şey yapıştırılmaz. Metnin yine de uygulamada olmasını istiyorsanız komutunuzun onu kendisi kopyalaması ya da yapıştırması gerekir.
- On saniye, soru yok. Komut girdi bekleyemez. Daha uzun işler için kendi arka plan işleminizi başlatın ve hızla çıkın.
- Kayıtlı dökümü değiştirmez. Komutun yazdırdığı hiçbir şey geri yazılmaz.
- Auto Send yoktur. Auto Send yalnızca Paste output ile çalışır, Custom Command ile çalışmaz.
- Yalnızca canlı dikte. Transcribe file kuyruğundaki dosyalar çıktı komutları çalıştırılmadan kaydedilir.
- Boş komut olmaz. Komutu boş bir Mode kaydedilemez.
Yerleşik şablonlar
VoiceInk’in Custom Commands belgelerinden, 10 Ekim 2026’da okunmuştur.
| Şablon | Ne yapar |
|---|---|
| Paste and Press Tab | Metni kopyalar, yapıştırır, sonra Tab tuşuna basar |
| Lowercase and Paste | Metni küçük harfe çevirir, kopyalar, sonra yapıştırır |
| Remove Trailing Period and Paste | Yapıştırmadan önce sondaki bir noktayı siler |
| Append to Journal | Metni ~/Documents/VoiceInk/journal.md dosyasına ekler |
| Search Web | Metin için bir web araması açar |
Belgeler bir şablondan başlayıp onu düzenlemenizi önerir. En basit iki örnekleri, metni kopyalamak ve bir nota eklemek:
printf "%s" "$VOICEINK_TRANSCRIPT" | pbcopymkdir -p "$HOME/Documents/VoiceInk"
printf -- "- %s\n" "$VOICEINK_TRANSCRIPT" >> "$HOME/Documents/VoiceInk/notes.md"İşe yarayıp yaramadığını kontrol etme
VoiceInk bir Custom Command sonrasında başarı ya da başarısızlık mesajı göstermez. Belgeler, son 10 dakikanın teslim günlüklerini, komutun başarılı olup olmadığı, başarısız olup olmadığı ya da 10 saniyeyi aşıp aşmadığı dahil, gösteren bir Terminal komutu verir:
/usr/bin/log show --last 10m --style compact \
--predicate 'subsystem == "com.prakashjoshipax.voiceink" AND category == "TranscriptionDelivery"'Belgeler bu günlüklerin dikte edilen metni içerebileceği konusunda uyarır. Ayrıca komutunuz metni bir web servisine gönderiyorsa o servis metni alır: VoiceInk yalnızca sizin yapılandırdığınızı çalıştırır.
YapToText nerede duruyor
VoiceInk bilgileri belgelerinden, 10 Ekim 2026’da okunmuştur. YapToText bilgileri kendi ayarlarından alınmıştır.
| VoiceInk | YapToText | |
|---|---|---|
| Metinle bir kabuk komutu çalıştırma | Evet, Custom Command çıktısı | Hayır |
| İmlecin olduğu yere yapıştırma | Paste output | Paste, varsayılan |
| Yapıştırmak yerine yazdırma | Bu sayfada anlatılmıyor | Type character by character |
| Yalnızca pano | pbcopy gibi bir komutla | Copy to clipboard only |
| Sonra bir tuşa basma | Paste and Press Tab şablonu | Uygulama başına Return ya da Command Return |
| Yerine gelmeden önce gözden geçirme | Bu sayfada anlatılmıyor | Review before inserting, varsayılan olarak kapalı |
Dikteyle kendi betiklerinizi çalıştırmak istiyorsanız VoiceInk’in Custom Command özelliği YapToText’in yapmadığı bir şey yapar. Metnin imlecin olduğu yerde, çevresindeki sözcüklere uyarak gelmesini istiyorsanız YapToText bunu varsayılan olarak yapar ve betik gerektirmez. Çıktı modlarının nerede ayarlandığını VoiceInk Modes sayfası anlatır, modlar etrafında kurulmuş başka bir uygulamayla karşılaştırma için VoiceInk ile superwhisper sayfasına bakın.
Ücretsiz indirilir. Hesap gerekmez, kilitli özellik yoktur. Apple çipli bir Mac ve macOS 14 veya sonrası gerekir. Kaynak kodu GitHub’da.
Kısa özet
- Nedir. Son metinle kabuk komutunuzu çalıştıran bir çıktı modu.
- Metin. Standart girdide ve $VOICEINK_TRANSCRIPT içinde.
- Sınırlar. 10 saniye, girdi yok, otomatik yapıştırma yok, yalnızca canlı dikte.
- Hata ayıklama. Uygulamada mesaj yok. Günlüğü yukarıdaki Terminal komutuyla okuyun.
- Buradan başlayın. Beş şablondan birini düzenleyin.
VoiceInk Custom Commands’ın çalışma biçimini değiştirirse GitHub’da bir issue açın, ben de bu sayfayı güncelleyeyim. 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://tryvoiceink.com/docs/custom-commands (kontrol tarihi 10.10.2026)
- https://tryvoiceink.com/docs/mode-settings (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
VoiceInk’te Custom Command nedir?
Bir çıktı modudur. VoiceInk yapıştırmak yerine sizin yazdığınız bir kabuk komutunu çalıştırır ve ona diktenin son metnini verir.
VoiceInk Custom Command metni nasıl alır?
Standart girdide ve $VOICEINK_TRANSCRIPT değişkeninde, UTF-8 olarak. Boşlukları ve satır sonlarını korumak için değişkeni tırnak içine alın.
VoiceInk Custom Command komutum neden hiçbir şey yapıştırmadı?
Custom Command çıktısı kendiliğinden yapıştırmaz. Paste and Press Tab şablonunun yaptığı gibi komutunuzun metni kendisi kopyalaması ya da yapıştırması gerekir.
VoiceInk Custom Command en fazla ne kadar çalışabilir?
10 saniye. Sonra VoiceInk onu durdurur. Daha uzun işler için bir arka plan işlemi başlatın.
YapToText’te VoiceInk gibi özel komutlar var mı?
Dikteden sonra kabuk komutu çalıştırmaz. İmlecin olduğu yere yapıştırır ya da yazar, yalnızca panoya kopyalayabilir ve metin yerine geldikten sonra Return tuşuna basabilir.