VoiceInk Custom Commands: envía tu dictado a un script en lugar de pegarlo
Por Ryleigh Newman · Publicado el
Custom Command es uno de los modos de salida de VoiceInk. En lugar de pegar, VoiceInk entrega el texto terminado de un dictado a un comando de shell que escribes tú, y ese comando decide qué pasa: añadirlo a una nota, abrir una búsqueda, llamar a tu propio script o enviarlo a un servicio que gestionas. Es lo más flexible que hace VoiceInk con el texto, y tiene algunos límites estrictos que conviene conocer antes de construir nada encima.
Creé YapToText, otra app de dictado para Mac, así que lee lo que digo de VoiceInk con eso en mente. Todos los datos sobre VoiceInk salen de su propia documentación, leída el 10 de octubre de 2026.
Descarga gratuita. Sin cuenta y sin nada bloqueado, para macOS 14 o posterior en un Mac con chip de Apple. Código fuente en GitHub.
Esta guía en otros idiomas: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
En esta página: 11 secciones
Qué recibe el comando
VoiceInk envía el mismo texto final de dos formas: por la entrada estándar y en la variable $VOICEINK_TRANSCRIPT. El texto es UTF-8, y la documentación pide que pongas la variable entre comillas para que se conserven los espacios, la puntuación y los saltos de línea.
- AI Enhancement desactivado. La transcripción después del formato y de los reemplazos de palabras de VoiceInk.
- AI Enhancement activado y funcionando. El texto mejorado.
- AI Enhancement omitido o fallido. La transcripción final sin más.
El comando nunca recibe directamente el audio, el prompt ni el texto seleccionado, del portapapeles o de la pantalla. Si quieres que el contexto dé forma al resultado, la documentación dice que uses un prompt y Context Awareness (el contexto de la app), para que ya esté en el texto final.
Cómo se ejecuta
De la documentación de VoiceInk, Custom Commands, leída el 10 de octubre de 2026.
| Detalle | Comportamiento |
|---|---|
| Shell | /bin/zsh -lc |
| Tiempo límite | 10 segundos, y después VoiceInk detiene el comando |
| Permisos | Los mismos permisos de usuario de macOS que VoiceInk |
| Grabadora | Se cierra antes de que empiece el comando |
| Éxito | Código de salida 0. Cualquier otro cuenta como fallo |
| Salida | La salida estándar y los errores se guardan para diagnóstico, nunca se pegan en la app |
| Comandos no encontrados | VoiceInk prueba el PATH de tu shell. Usa una ruta completa como /opt/homebrew/bin/tool si falla |
Los límites con los que se tropieza
- No se pega nada por ti. Si aun así quieres el texto en la app, tu comando tiene que copiarlo o pegarlo él mismo.
- Diez segundos, sin preguntas. El comando no puede esperar a que escribas nada. Para trabajos más largos, inicia tu propio proceso en segundo plano y termina rápido.
- No cambia la transcripción guardada. Lo que imprime el comando no se escribe de vuelta.
- Sin Auto Send. Auto Send solo funciona con la salida Paste, no con Custom Command.
- Solo dictado en directo. Los archivos de la cola de Transcribe file se guardan sin ejecutar comandos de salida.
- Sin comando vacío. Un Mode con el comando vacío no se puede guardar.
Las plantillas incluidas
De la documentación de VoiceInk, Custom Commands, leída el 10 de octubre de 2026.
| Plantilla | Qué hace |
|---|---|
| Paste and Press Tab | Copia el texto, lo pega y después pulsa Tab |
| Lowercase and Paste | Pasa el texto a minúsculas, lo copia y después lo pega |
| Remove Trailing Period and Paste | Quita un punto final antes de pegar |
| Append to Journal | Añade el texto a ~/Documents/VoiceInk/journal.md |
| Search Web | Abre una búsqueda web con el texto |
La documentación sugiere empezar por una plantilla y editarla. Estos son dos de sus ejemplos más sencillos, copiar el texto y añadirlo a una nota:
printf "%s" "$VOICEINK_TRANSCRIPT" | pbcopymkdir -p "$HOME/Documents/VoiceInk"
printf -- "- %s\n" "$VOICEINK_TRANSCRIPT" >> "$HOME/Documents/VoiceInk/notes.md"Comprobar si funcionó
VoiceInk no muestra ningún mensaje de éxito o fallo después de un Custom Command. La documentación da un comando de Terminal que muestra los registros de entrega de los últimos 10 minutos, con si el comando tuvo éxito, falló o pasó de los 10 segundos:
/usr/bin/log show --last 10m --style compact \
--predicate 'subsystem == "com.prakashjoshipax.voiceink" AND category == "TranscriptionDelivery"'La documentación avisa de que estos registros pueden contener texto dictado. Y si tu comando envía texto a un servicio web, ese servicio lo recibe: VoiceInk solo ejecuta lo que tú configuraste.
Dónde está YapToText
VoiceInk según su documentación, leída el 10 de octubre de 2026. YapToText según sus propios ajustes.
| VoiceInk | YapToText | |
|---|---|---|
| Ejecutar un comando de shell con el texto | Sí, con la salida Custom Command | No |
| Pegar en el cursor | Salida Paste | Paste, la opción por defecto |
| Escribirlo en lugar de pegarlo | No se describe en esta página | Type character by character |
| Solo al portapapeles | Con un comando como pbcopy | Copy to clipboard only |
| Pulsar una tecla después | Plantilla Paste and Press Tab | Return o Command Return según la app |
| Revisar antes de que llegue | No se describe en esta página | Review before inserting, desactivado por defecto |
Si quieres que el dictado maneje tus propios scripts, el Custom Command de VoiceInk hace algo que YapToText no hace. Si quieres el texto en el cursor, adaptado a las palabras de alrededor, YapToText lo hace por defecto y no necesita ningún script. La página de los Modes de VoiceInk explica dónde se configuran los modos de salida, y VoiceInk frente a superwhisper lo compara con otra app construida en torno a los modos.
Descarga gratuita. Sin cuenta y sin nada bloqueado, para macOS 14 o posterior en un Mac con chip de Apple. Código fuente en GitHub.
En resumen
- Qué es. Un modo de salida que ejecuta tu comando de shell con el texto final.
- El texto. Por la entrada estándar y en $VOICEINK_TRANSCRIPT.
- Límites. 10 segundos, sin entrada, sin pegado automático, solo dictado en directo.
- Depuración. No hay mensaje en la app. Lee el registro con el comando de Terminal de arriba.
- Para empezar. Edita una de las cinco plantillas.
Si VoiceInk cambia cómo funcionan los Custom Commands, abre un issue en GitHub y actualizaré esta página. Los leo todos.
Descarga gratuita. Sin cuenta y sin nada bloqueado, para macOS 14 o posterior en un Mac con chip de Apple. Código fuente en GitHub.
Guías
Más guías, en inglés
Fuentes
- https://tryvoiceink.com/docs/custom-commands (consultado el 10 de octubre de 2026)
- https://tryvoiceink.com/docs/mode-settings (consultado el 10 de octubre de 2026)
- https://github.com/ryleighnewman/YapToText (consultado el 10 de octubre de 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (consultado el 10 de octubre de 2026)
Preguntas
¿Qué es un Custom Command en VoiceInk?
Un modo de salida. En lugar de pegar, VoiceInk ejecuta un comando de shell que escribes tú y le pasa el texto final del dictado.
¿Cómo recibe el texto un Custom Command de VoiceInk?
Por la entrada estándar y en la variable $VOICEINK_TRANSCRIPT, en UTF-8. Pon la variable entre comillas para conservar los espacios y los saltos de línea.
¿Por qué mi Custom Command de VoiceInk no pegó nada?
La salida Custom Command no pega por sí sola. Tu comando tiene que copiar o pegar el texto él mismo, como hace la plantilla Paste and Press Tab.
¿Cuánto tiempo puede ejecutarse un Custom Command de VoiceInk?
10 segundos. Después VoiceInk lo detiene. Inicia un proceso en segundo plano para trabajos más largos.
¿YapToText tiene comandos personalizados como VoiceInk?
No ejecuta comandos de shell después de un dictado. Pega o escribe en el cursor, puede copiar solo al portapapeles y puede pulsar Return después de que llegue el texto.