SolucionesMac8 min de lectura
VoiceInk no transcribe: cómo encontrar la falla
¿VoiceInk no transcribe? Revisa la captura del micrófono, luego el Mode y el modelo, y después el pegado, con los diagnósticos oficiales de VoiceInk.
Publicado por Optimal Apps, el creador de Petal.
En esta página
Cuando VoiceInk no transcribe, la falla está en uno de tres pasos: la captura del micrófono, el modelo o el pegado. La guía oficial de VoiceInk "Transcription Failing or No Output" los revisa en ese orden. Primero confirma Micrófono y Accesibilidad en Configuración del Sistema > Privacidad y seguridad y reinicia VoiceInk. Luego abre Audio en la barra lateral de VoiceInk y confirma la entrada. Después comprueba que el Mode activo tenga un modelo de transcripción válido y que el modelo esté descargado en AI Models. Si el texto aparece en VoiceInk pero no en tu app, el problema está en el pegado.
Lista rápida de soluciones
| Síntoma | Paso que falla | Solución |
|---|---|---|
| La grabadora no muestra nivel de audio | Captura | Selecciona el micrófono en Audio; revisa Sonido > Entrada |
| No hay resultado después de cambiar un permiso | Captura | Reinicia VoiceInk |
| Un micrófono nuevo no aparece en la lista | Captura | Haz clic en Refresh Microphones |
| Un Mode no da resultado | Modelo | Activa el Mode y elige un modelo válido |
| Un modelo local no da nada | Modelo | Descárgalo en AI Models; revisa los archivos .bin importados |
| Falla un modelo en la nube | Modelo | Revisa la clave de API y la red |
| El texto aparece en VoiceInk, pero no en tu app | Pegado | Sigue la guía de pegado |
| El texto sale mal, pero sí sale | Modelo | Prueba otro modelo; agrega Vocabulary |
Paso 1: Diagnostica en tres partes por qué VoiceInk no transcribe
Haz una prueba antes de cambiar la configuración.
- Abre Editor de Texto y haz clic en un documento nuevo.
- Usa tu atajo de VoiceInk y di una frase clara.
- Mira la grabadora mientras hablas y luego revisa el resultado en el historial de VoiceInk.
Ahora ubica la falla:
- El nivel de audio no se mueve. Falla la captura. Ve al paso 2.
- El nivel se mueve, pero no hay texto en VoiceInk. Falla el modelo. Ve al paso 4.
- VoiceInk muestra el texto, pero Editor de Texto está vacío. Falla el pegado. Ve al paso 6.
Paso 2: Revisa los permisos
La documentación de VoiceInk indica tres permisos:
- Micrófono es necesario para grabar.
- Accesibilidad es necesaria para un pegado confiable y para usar el texto seleccionado como contexto.
- Grabación de pantalla solo es necesaria cuando un Mode usa el contexto de la pantalla.
- Abre Configuración del Sistema > Privacidad y seguridad > Micrófono y asegúrate de que VoiceInk esté activado.
- Abre Configuración del Sistema > Privacidad y seguridad > Accesibilidad y asegúrate de que VoiceInk esté activado.
- Reinicia VoiceInk después de cualquier cambio. La documentación de VoiceInk dice que este paso es necesario.
Si compilaste VoiceInk desde el código fuente o instalaste una versión nueva, el interruptor puede aparecer activado y aun así fallar. macOS vincula el permiso de Accesibilidad a la firma de código de la app, y una firma nueva no coincide con el permiso anterior. El issue #530 de VoiceInk en GitHub da la solución: ejecuta tccutil reset Accessibility com.prakashjoshipax.VoiceInk en Terminal, vuelve a abrir VoiceInk y otorga Accesibilidad otra vez.
Para una guía general, lee Permiso de micrófono en Mac.
Paso 3: Revisa la entrada de audio
- En la barra lateral de VoiceInk, abre Audio.
- Usa Selected Microphone para elegir un dispositivo. O usa Priority Order para que VoiceInk pase a otro de varios dispositivos cuando falte uno.
- Si acabas de conectar un dispositivo nuevo, haz clic en Refresh Microphones.
- Abre Configuración del Sistema > Sonido > Entrada, habla y confirma que el nivel de entrada se mueve en ese mismo dispositivo.
Por qué funciona: VoiceInk graba desde el dispositivo que tiene seleccionado. Si ese dispositivo está desconectado, en reposo o silenciado, el modelo recibe silencio y no devuelve nada.
VoiceInk recomienda el micrófono integrado de la Mac o un micrófono externo dedicado en lugar del micrófono de unos audífonos inalámbricos. Los audífonos Bluetooth suelen cambiar a un modo de baja calidad para el micrófono. Consulta Dictado con micrófono Bluetooth en Mac.
También hay un reporte abierto (issue #916 en GitHub) en el que VoiceInk guardó audio completamente silencioso en una configuración, y solo grabó bien mientras el Dictado de macOS estaba activo al mismo tiempo. Si el medidor de nivel se mueve en la configuración de Sonido pero VoiceInk graba silencio, menciona ese issue cuando reportes el problema.
Paso 4: Revisa el Mode activo
Los Modes deciden qué modelo y qué salida usa VoiceInk. Un Mode con un ajuste equivocado es una causa común de "no hay resultado".
- Abre Modes en la barra lateral.
- Confirma que el Mode que usas está activado.
- Confirma que tiene un modelo de transcripción válido y que el proveedor o el modelo local están disponibles.
- Confirma que el ajuste de idioma coincide con el idioma en que hablas.
- Revisa el tipo de salida: Paste inserta texto, Respond muestra una respuesta en la grabadora y Custom Command envía el texto a tu comando. Si la salida es Respond, el texto no va a tu app, y eso es lo esperado.
Paso 5: Soluciona que VoiceInk no carga el modelo
Abre AI Models y revisa el modelo que usa el Mode.
Modelos locales
- Confirma que el modelo está descargado.
- Si importaste un archivo
.binde Whisper, confirma que el archivo sigue existiendo y se puede leer. Si lo moviste o lo eliminaste, vuelve a importarlo. - Los modelos solo de streaming necesitan el modo Real-time. Los archivos importados necesitan un modelo que admita procesamiento por lotes.
- Apple Speech requiere macOS 26 o posterior y el recurso del idioma instalado.
- La mejora VoiceInk Refine necesita Apple silicon, al menos 16 GB de RAM y un modelo Refine descargado.
En las Mac con Intel, la documentación de VoiceInk dice que la transcripción en la nube suele funcionar mejor, porque ahí los modelos locales son lentos. Un modelo lento puede parecer que no da resultado.
Proveedores en la nube
- Confirma que la clave de API está configurada y que el proveedor admite transcripción.
- Para un modelo personalizado, revisa la ruta del endpoint, la clave de API y el nombre del modelo. VoiceInk aclara que guardar no prueba la conexión, así que un error de escritura solo falla al transcribir.
- Revisa la red. En el issue #1010 de GitHub, un usuario en una red corporativa veía un error de transcripción. La causa era un modelo en la nube seleccionado por error. La solución fue descargar el modelo local y configurarlo en los Modes.
Paso 6: Distingue un problema de pegado
Si VoiceInk muestra la transcripción pero tu app sigue vacía, la transcripción funciona. Falla el pegado. La guía de portapapeles de VoiceInk da estos pasos:
- Confirma que el Mode usa la salida Paste.
- Haz clic en el campo de destino antes de grabar.
- Confirma Accesibilidad (paso 2).
- Abre Settings > Pasting y cambia Paste Method de Default a AppleScript.
- Si se pega el contenido viejo del portapapeles, aumenta el Restore Delay. El valor predeterminado es 2 segundos, y el rango va de 250 ms a 5 segundos.
La guía completa está en VoiceInk no pega el texto.
Paso 7: Si el texto sale mal pero sí sale
Si VoiceInk transcribe pero el texto tiene errores:
- Prueba otro modelo en el Mode. La documentación de VoiceInk sugiere Parakeet V3 para dictar rápido en local en las Mac compatibles.
- Agrega correcciones fijas en Word Replacements y nombres importantes en Vocabulary.
- Acércate al micrófono y reduce el ruido de fondo.
Paso 8: Recopila diagnósticos
Si ninguno de los pasos funciona, usa Diagnostics and Support de VoiceInk para recopilar información del sistema o exportar los registros. Revisa los registros antes de compartirlos y luego reporta el problema en el GitHub de VoiceInk o a su soporte.
Petal: una versión gratis y firmada con modelos en el dispositivo
El código fuente de VoiceInk es GPL v3, y puedes compilarlo tú mismo gratis. La versión firmada y lista para usar es una licencia de pago único. Si quieres una versión firmada y lista sin costo, Petal para Mac es una opción. Es gratis y de código abierto (MIT), de Optimal Apps, el editor de este sitio. La descarga en GitHub Releases está firmada con un Developer ID y se actualiza con Sparkle, así que los permisos de macOS siguen vinculados a la misma firma entre versiones.
Así se relaciona Petal con los mismos tres pasos:
- Captura. Elige el dispositivo en Settings > Recording > Microphone, o deja Default para seguir al sistema.
- Modelo. Descarga un modelo de voz en Settings > Models. Parakeet 110M es el modelo ligero recomendado para inglés. Parakeet 0.6B V3 cubre 25 idiomas europeos, incluido el español, Whisper Large V3 Turbo cubre 99 idiomas y Apple Speech no necesita descarga. Todos se ejecutan en tu Mac. Petal mantiene por debajo de 8 GB la memoria RAM que necesita su modelo predeterminado.
- Pegado. Petal pega en la app que está al frente y restaura tu portapapeles 700 ms después, para que las apps Electron lentas reciban el texto correcto. Si Accesibilidad está desactivada, Petal copia la transcripción en su lugar.
Cada grabación y su transcripción se guardan en el historial, y Transcribe Again vuelve a procesar el audio guardado. La limpieza con Petal W1 también se ejecuta en tu Mac. Petal requiere macOS 26.2 o posterior.
Para una comparación directa, lee Petal vs VoiceInk o Alternativa a VoiceInk para Mac.
Resumen
- Haz una prueba para saber qué paso falla: captura, modelo o pegado.
- Confirma Micrófono y Accesibilidad, y reinicia VoiceInk.
- Después de compilar una versión nueva, restablece el permiso de Accesibilidad con
tccutil. - Selecciona el micrófono en Audio y confirma el nivel en la configuración de Sonido.
- Comprueba que el Mode esté activado, tenga un modelo válido y use la salida Paste.
- Confirma que el modelo esté descargado, o que la clave de la nube y la red funcionen.
- Si el texto aparece en VoiceInk pero no en tu app, corrige el paso de pegado.
Preguntas
¿Por qué VoiceInk no transcribe nada?
La documentación de VoiceInk menciona cinco causas comunes: falta un permiso de macOS, el micrófono es el equivocado, un Mode tiene ajustes inesperados, un modelo local es demasiado lento para la Mac o hay un problema de tiempos al pegar en la app de destino. Revísalas en ese orden.
¿Por qué VoiceInk no da resultado con un modelo local?
Confirma que el modelo esté descargado en AI Models y seleccionado en el Mode activo. Si importaste un archivo .bin de Whisper, confirma que el archivo sigue existiendo y se puede leer. Los modelos solo de streaming necesitan el modo Real-time.
¿VoiceInk necesita internet?
No, si usas un modelo local descargado. Un proveedor de transcripción en la nube necesita internet y una clave de API válida. Si la transcripción falla en una red de trabajo, comprueba que el Mode no use un modelo en la nube por error.
¿Hay una alternativa gratis y firmada a VoiceInk?
Petal para Mac es gratis y de código abierto, y la versión en GitHub está firmada. Ejecuta Parakeet, Whisper, Qwen3 ASR y otros modelos de voz en tu Mac.