VoiceInk Custom Command: kirim dikte Anda ke skrip, bukan menempelkannya
Oleh Ryleigh Newman · Diterbitkan
Custom Command (perintah kustom) adalah salah satu mode output VoiceInk. Alih-alih menempel, VoiceInk menyerahkan teks akhir dari sebuah dikte ke perintah shell yang Anda tulis, dan perintah itulah yang menentukan apa yang terjadi: menambahkannya ke catatan, membuka pencarian, memanggil skrip Anda sendiri, atau mengirimkannya ke layanan yang Anda jalankan. Ini hal paling fleksibel yang dilakukan VoiceInk dengan teks, dan ada beberapa batasan keras yang perlu diketahui sebelum Anda membangun di atasnya.
Saya membuat YapToText, app dikte lain untuk Mac, jadi bacalah apa yang saya tulis tentang VoiceInk dengan itu dalam pikiran. Semua fakta tentang VoiceInk di sini berasal dari dokumentasinya sendiri, 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, 简体中文, 繁體中文
Yang diterima perintah
VoiceInk mengirim teks akhir yang sama dengan dua cara: lewat standard input, dan dalam variabel $VOICEINK_TRANSCRIPT. Teksnya berupa UTF-8, dan dokumentasinya meminta Anda memberi tanda kutip pada variabel itu agar spasi, tanda baca, dan jeda baris tetap utuh.
- AI Enhancement (peningkatan AI) mati. Transkrip setelah pemformatan dan penggantian kata dari VoiceInk.
- AI Enhancement menyala dan berhasil. Teks yang sudah ditingkatkan.
- AI Enhancement dilewati atau gagal. Transkrip akhir yang apa adanya.
Perintah itu tidak pernah menerima audio, prompt, atau teks yang dipilih, isi papan klip, maupun layar secara langsung. Jika Anda ingin konteks memengaruhi hasilnya, dokumentasinya menyarankan memakai prompt dan Context Awareness (kesadaran konteks), sehingga konteks itu sudah ada di teks akhir.
Cara menjalankannya
Dari dokumentasi VoiceInk, Custom Commands, dibaca 10 Oktober 2026.
| Rincian | Perilaku |
|---|---|
| Shell | /bin/zsh -lc |
| Batas waktu | 10 detik, lalu VoiceInk menghentikan perintah |
| Izin | Izin pengguna macOS yang sama dengan VoiceInk |
| Perekam | Ditutup sebelum perintah dimulai |
| Berhasil | Exit code 0. Yang lain dianggap gagal |
| Output | Standard output dan error disimpan untuk diagnostik, tidak pernah ditempelkan ke app |
| Perintah tidak ditemukan | VoiceInk mencoba PATH shell Anda. Pakai path lengkap seperti /opt/homebrew/bin/tool jika gagal |
Batasan yang sering mengejutkan
- Tidak ada yang ditempelkan untuk Anda. Jika Anda tetap ingin teksnya ada di app, perintah Anda harus menyalin atau menempelkannya sendiri.
- Sepuluh detik, tanpa pertanyaan. Perintah tidak dapat menunggu input. Untuk pekerjaan yang lebih lama, jalankan proses latar belakang Anda sendiri lalu keluar dengan cepat.
- Transkrip yang tersimpan tidak berubah. Apa pun yang dicetak perintah tidak ditulis kembali.
- Tidak ada Auto Send. Auto Send hanya bekerja dengan Paste output, bukan dengan Custom Command.
- Hanya dikte langsung. File dalam antrean Transcribe file disimpan tanpa menjalankan perintah output.
- Tidak boleh perintah kosong. Sebuah Mode dengan perintah kosong tidak dapat disimpan.
Template bawaan
Dari dokumentasi VoiceInk, Custom Commands, dibaca 10 Oktober 2026.
| Template | Fungsinya |
|---|---|
| Paste and Press Tab | Menyalin teks, menempelkannya, lalu menekan Tab |
| Lowercase and Paste | Mengubah teks menjadi huruf kecil, menyalinnya, lalu menempelkannya |
| Remove Trailing Period and Paste | Membuang satu titik terakhir sebelum menempel |
| Append to Journal | Menambahkan teks ke ~/Documents/VoiceInk/journal.md |
| Search Web | Membuka pencarian web untuk teks tersebut |
Dokumentasinya menyarankan memulai dari sebuah template lalu mengeditnya. Dua contoh paling sederhana dari mereka, menyalin teks dan menambahkannya ke catatan:
printf "%s" "$VOICEINK_TRANSCRIPT" | pbcopymkdir -p "$HOME/Documents/VoiceInk"
printf -- "- %s\n" "$VOICEINK_TRANSCRIPT" >> "$HOME/Documents/VoiceInk/notes.md"Memeriksa apakah berhasil
VoiceInk tidak menampilkan pesan berhasil atau gagal setelah sebuah Custom Command. Dokumentasinya memberi perintah Terminal yang menampilkan log pengiriman 10 menit terakhir, termasuk apakah perintah berhasil, gagal, atau berjalan lebih dari 10 detik:
/usr/bin/log show --last 10m --style compact \
--predicate 'subsystem == "com.prakashjoshipax.voiceink" AND category == "TranscriptionDelivery"'Dokumentasinya memperingatkan bahwa log ini dapat berisi teks yang Anda diktekan. Dan jika perintah Anda mengirim teks ke layanan web, layanan itu menerimanya: VoiceInk hanya menjalankan apa yang Anda atur.
Posisi YapToText
VoiceInk dari dokumentasinya, dibaca 10 Oktober 2026. YapToText dari pengaturannya sendiri.
| VoiceInk | YapToText | |
|---|---|---|
| Menjalankan perintah shell dengan teks | Ya, output Custom Command | Tidak |
| Menempel di posisi kursor | Paste output | Tempel, yang menjadi default |
| Mengetik sebagai gantinya | Tidak dijelaskan di halaman ini | Ketik karakter demi karakter |
| Hanya papan klip | Dengan perintah seperti pbcopy | Salin ke papan klip saja |
| Menekan tombol setelahnya | Template Paste and Press Tab | Return atau Command Return per app |
| Meninjau sebelum teks masuk | Tidak dijelaskan di halaman ini | Tinjau sebelum menyisipkan, mati secara default |
Jika Anda ingin dikte menjalankan skrip Anda sendiri, Custom Command VoiceInk melakukan sesuatu yang tidak dilakukan YapToText. Jika Anda ingin teks di posisi kursor, disesuaikan dengan kata-kata di sekitarnya, YapToText melakukannya secara default dan tidak memerlukan skrip. Halaman Mode VoiceInk membahas tempat mode output diatur, dan VoiceInk dibandingkan superwhisper membandingkannya dengan app lain yang dibangun di sekitar mode.
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
- Apa itu. Mode output yang menjalankan perintah shell Anda dengan teks akhir.
- Teksnya. Lewat standard input dan dalam $VOICEINK_TRANSCRIPT.
- Batasan. 10 detik, tanpa input, tanpa tempel otomatis, hanya dikte langsung.
- Debugging. Tidak ada pesan di app. Baca log dengan perintah Terminal di atas.
- Mulai dari sini. Edit salah satu dari lima template.
Jika VoiceInk mengubah cara kerja Custom Command, buka issue di GitHub dan saya akan memperbarui halaman ini. Semuanya saya baca.
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://tryvoiceink.com/docs/custom-commands (diperiksa 10/10/2026)
- https://tryvoiceink.com/docs/mode-settings (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
Apa itu Custom Command di VoiceInk?
Sebuah mode output. Alih-alih menempel, VoiceInk menjalankan perintah shell yang Anda tulis dan menyerahkan teks akhir dari dikte itu kepadanya.
Bagaimana Custom Command VoiceInk mendapatkan teksnya?
Lewat standard input dan dalam variabel $VOICEINK_TRANSCRIPT, sebagai UTF-8. Beri tanda kutip pada variabel itu agar spasi dan jeda baris tetap utuh.
Mengapa Custom Command VoiceInk saya tidak menempelkan apa pun?
Output Custom Command tidak menempel dengan sendirinya. Perintah Anda harus menyalin atau menempelkan teksnya sendiri, seperti yang dilakukan template Paste and Press Tab.
Berapa lama Custom Command VoiceInk boleh berjalan?
10 detik. Setelah itu VoiceInk menghentikannya. Jalankan proses latar belakang untuk pekerjaan yang lebih lama.
Apakah YapToText punya perintah kustom seperti VoiceInk?
Tidak menjalankan perintah shell setelah dikte. App ini menempel atau mengetik di posisi kursor, dapat menyalin ke papan klip saja, dan dapat menekan Return setelah teks masuk.