VoiceInk Custom Commands: mandare la dettatura a uno script invece di incollarla
Di Ryleigh Newman · Pubblicato il
Custom Command (comando personalizzato) è una delle modalità di output di VoiceInk. Invece di incollare, VoiceInk passa il testo finito di una dettatura a un comando di shell che scrivi tu, e quel comando decide che cosa succede: aggiungerlo a una nota, aprire una ricerca, chiamare uno script tuo o inviarlo a un servizio che gestisci. È la cosa più flessibile che VoiceInk fa con il testo, e ha alcuni limiti rigidi da conoscere prima di costruirci sopra.
Ho creato YapToText, un'altra app di dettatura per Mac, quindi leggi ciò che scrivo su VoiceInk tenendolo presente. Ogni fatto su VoiceInk qui viene dalla sua documentazione, letta il 10 ottobre 2026.
Download gratuito. Senza account e senza niente di bloccato, per macOS 14 o versioni successive su un Mac con chip Apple. Codice sorgente su GitHub.
Questa guida in altre lingue: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
In questa pagina: 11 sezioni
Che cosa riceve il comando
VoiceInk invia lo stesso testo finale in due modi: sullo standard input e nella variabile $VOICEINK_TRANSCRIPT. Il testo è in UTF-8, e la documentazione chiede di mettere la variabile tra virgolette perché spazi, punteggiatura e a capo si conservino.
- AI Enhancement disattivato. La trascrizione dopo la formattazione e le sostituzioni di parole di VoiceInk.
- AI Enhancement attivo e funzionante. Il testo migliorato.
- AI Enhancement saltato o non riuscito. La semplice trascrizione finale.
Il comando non riceve mai direttamente l'audio, il prompt, né il testo selezionato, degli appunti o dello schermo. Se vuoi che il contesto influisca sul risultato, la documentazione dice di usare un prompt e Context Awareness, così è già nel testo finale.
Come viene eseguito
Dalla documentazione di VoiceInk, Custom Commands, letta il 10 ottobre 2026.
| Dettaglio | Comportamento |
|---|---|
| Shell | /bin/zsh -lc |
| Tempo massimo | 10 secondi, poi VoiceInk ferma il comando |
| Permessi | Gli stessi permessi dell'utente macOS di VoiceInk |
| Registratore | Chiuso prima che il comando parta |
| Successo | Codice di uscita 0. Qualsiasi altro valore conta come un errore |
| Output | Standard output ed errori vengono conservati per la diagnostica, mai incollati nell'app |
| Comandi non trovati | VoiceInk prova il PATH della tua shell. Se non basta, usa un percorso completo come /opt/homebrew/bin/tool |
I limiti in cui si inciampa
- Nulla viene incollato al posto tuo. Se vuoi comunque il testo nell'app, il comando deve copiarlo o incollarlo da sé.
- Dieci secondi, nessuna domanda. Il comando non può aspettare un input. Per un lavoro più lungo, avvia un tuo processo in background ed esci subito.
- Non cambia la trascrizione salvata. Ciò che il comando stampa non viene riscritto nella trascrizione.
- Niente Auto Send. Auto Send funziona solo con l'output Paste, non con Custom Command.
- Solo dettatura dal vivo. I file nella coda di Transcribe file vengono salvati senza eseguire i comandi di output.
- Nessun comando vuoto. Una modalità (Mode) con un comando vuoto non si può salvare.
I modelli integrati
Dalla documentazione di VoiceInk, Custom Commands, letta il 10 ottobre 2026.
| Modello | Cosa fa |
|---|---|
| Paste and Press Tab | Copia il testo, lo incolla, poi preme Tab |
| Lowercase and Paste | Mette il testo in minuscolo, lo copia, poi lo incolla |
| Remove Trailing Period and Paste | Toglie un punto finale prima di incollare |
| Append to Journal | Aggiunge il testo a ~/Documents/VoiceInk/journal.md |
| Search Web | Apre una ricerca sul web per il testo |
La documentazione consiglia di partire da un modello e di modificarlo. Due dei loro esempi più semplici, copiare il testo e aggiungerlo a una nota:
printf "%s" "$VOICEINK_TRANSCRIPT" | pbcopymkdir -p "$HOME/Documents/VoiceInk"
printf -- "- %s\n" "$VOICEINK_TRANSCRIPT" >> "$HOME/Documents/VoiceInk/notes.md"Controllare se ha funzionato
VoiceInk non mostra nessun messaggio di successo o di errore dopo un Custom Command. La documentazione indica un comando per il Terminale che mostra gli ultimi 10 minuti di log di consegna, compreso se il comando è riuscito, è fallito o ha superato i 10 secondi:
/usr/bin/log show --last 10m --style compact \
--predicate 'subsystem == "com.prakashjoshipax.voiceink" AND category == "TranscriptionDelivery"'La documentazione avverte che questi log possono contenere il testo dettato. E se il tuo comando invia il testo a un servizio web, quel servizio lo riceve: VoiceInk esegue soltanto ciò che hai configurato.
Dove si colloca YapToText
VoiceInk dalla sua documentazione, letta il 10 ottobre 2026. YapToText dalle sue impostazioni.
| VoiceInk | YapToText | |
|---|---|---|
| Eseguire un comando di shell con il testo | Sì, l'output Custom Command | No |
| Incollare al cursore | Output Paste | Paste, l'impostazione predefinita |
| Digitarlo invece | Non descritto in questa pagina | Type character by character |
| Solo negli appunti | Con un comando come pbcopy | Copy to clipboard only |
| Premere un tasto dopo | Modello Paste and Press Tab | Return o Command Return per app |
| Rivedere prima che arrivi | Non descritto in questa pagina | Review before inserting, disattivato per impostazione predefinita |
Se vuoi che la dettatura guidi i tuoi script, Custom Command di VoiceInk fa qualcosa che YapToText non fa. Se vuoi il testo al cursore, adattato alle parole che lo circondano, YapToText lo fa per impostazione predefinita e non ha bisogno di nessuno script. La pagina sulle modalità di VoiceInk spiega dove si impostano le modalità di output, e VoiceInk a confronto con superwhisper lo mette a confronto con un'altra app costruita sulle modalità.
Download gratuito. Senza account e senza niente di bloccato, per macOS 14 o versioni successive su un Mac con chip Apple. Codice sorgente su GitHub.
In breve
- Che cos'è. Una modalità di output che esegue il tuo comando di shell con il testo finale.
- Il testo. Sullo standard input e in $VOICEINK_TRANSCRIPT.
- Limiti. 10 secondi, nessun input, nessun incolla automatico, solo dettatura dal vivo.
- Debug. Nessun messaggio nell'app. Leggi il log con il comando per il Terminale qui sopra.
- Da dove partire. Modifica uno dei cinque modelli.
Se VoiceInk cambia il modo in cui funzionano i Custom Commands, apri una issue su GitHub e aggiornerò questa pagina. Le leggo tutte.
Download gratuito. Senza account e senza niente di bloccato, per macOS 14 o versioni successive su un Mac con chip Apple. Codice sorgente su GitHub.
Guide
Altre guide, in inglese
Fonti
- https://tryvoiceink.com/docs/custom-commands (consultato il 10 ottobre 2026)
- https://tryvoiceink.com/docs/mode-settings (consultato il 10 ottobre 2026)
- https://github.com/ryleighnewman/YapToText (consultato il 10 ottobre 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (consultato il 10 ottobre 2026)
Domande
Che cos'è un Custom Command in VoiceInk?
Una modalità di output. Invece di incollare, VoiceInk esegue un comando di shell che scrivi tu e gli passa il testo finale della dettatura.
Come riceve il testo un Custom Command di VoiceInk?
Sullo standard input e nella variabile $VOICEINK_TRANSCRIPT, in UTF-8. Metti la variabile tra virgolette per conservare spazi e a capo.
Perché il mio Custom Command di VoiceInk non ha incollato nulla?
L'output Custom Command non incolla da solo. Il tuo comando deve copiare o incollare il testo da sé, come fa il modello Paste and Press Tab.
Per quanto tempo può girare un Custom Command di VoiceInk?
10 secondi. Dopo, VoiceInk lo ferma. Per un lavoro più lungo avvia un processo in background.
YapToText ha comandi personalizzati come VoiceInk?
Non esegue comandi di shell dopo una dettatura. Incolla o digita al cursore, può copiare solo negli appunti e può premere Return dopo l'arrivo del testo.