Guía independiente · Solución de problemas
Cuando OpenWhispr no funciona
Casi todo lo que falla en OpenWhispr falla por lo mismo: un permiso que el sistema concede y la aplicación no reconoce, o una herramienta que falta. Aquí están los casos reales, con la solución de cada uno y separados por sistema, porque el programa no se comporta igual en los tres.
Empieza por aquí
Entra por tu sistema: cada uno se comporta de forma distinta y tiene su propia lista.
Lo que cambia de un sistema a otro
Esta tabla es el resumen de por qué la página va separada por plataformas: no son matices, son comportamientos distintos.
| macOS | Windows | Linux | |
|---|---|---|---|
| Mantener pulsado para grabar | sí | sí con su auxiliar | no no soportado |
| Qué escribe el texto | permiso de accesibilidad | windows-fast-paste | linux-fast-paste, o xdotool / wtype |
| Dónde guarda los modelos | ~/.cache/openwhispr/ | %USERPROFILE%\.cache\openwhispr\ | ~/.cache/openwhispr/ |
| Al desinstalar borra los modelos | no a mano | sí | depende sí en .deb y .rpm, no en AppImage |
| Mínimo para funcionar | macOS 12 · 13.3 para transcribir en local | Windows 10 x64 | x64 con PulseAudio o PipeWire |
GEN-01 Lo más frecuente
No escribe el texto, pero sí lo ha transcrito
No has perdido lo dictado. OpenWhispr copia siempre el texto al portapapeles, aunque el pegado automático falle: se pega a mano con ⌘V o Ctrl+V y sigues trabajando.
A partir de ahí la causa depende del sistema: en macOS casi siempre es el permiso de accesibilidad (MAC-01) y en Linux una herramienta que falta (LNX-01).
GEN-02 Configuración
No detecta audio
Tres comprobaciones, en este orden:
- Que el micrófono tenga el permiso concedido.
- Que en los ajustes de sonido del sistema esté seleccionada la entrada que de verdad estás usando.
- Que en los ajustes de OpenWhispr aparezca ese mismo dispositivo.
Cambiar de dispositivo de entrada y volver resuelve buena parte de los casos. La aplicación tiene además un modo de depuración que registra el nivel de audio: si ahí no se mueve nada, el problema está antes del programa.
GEN-03 Configuración
Transcribe vacío o no transcribe nada
Con transcripción local, lo habitual es que el modelo no esté descargado del todo —se comprueba en Ajustes → Reconocimiento de voz— o que falte espacio en disco: los modelos van de 75 MB a 1,6 GB. Con el modo de nube, revisa que la clave de API sea válida y que tenga crédito.
Cambiar de local a nube, o al revés, es la forma rápida de saber en qué lado está el fallo.
GEN-04 Incidencia abierta
Escribe frases que no has dicho
En los silencios el modelo Whisper puede «alucinar» y colar frases de cierre de vídeo; la más reportada es «Thank you for watching!». No es un fallo de OpenWhispr sino un comportamiento conocido del modelo, y está abierto como incidencia.
Lo que ayuda: soltar el atajo en cuanto acabas de hablar, en vez de dejar la grabación abierta escuchando silencio.
GEN-05 Conflicto de teclas
El atajo no responde
Lo más común es un choque con otro programa o con un atajo del sistema. Se puede cambiar la combinación en los ajustes, o definir un atajo de respaldo.
El «mantener pulsado y soltar» no funciona igual en los tres sistemas: en Linux no está disponible. Lo explica LNX-02.
Plataforma 01
macOS
MAC-01 Incidencia abierta
Transcribe pero no escribe: el permiso de accesibilidad
Es el tropiezo número uno. macOS concede el permiso de accesibilidad y la aplicación no lo reconoce, así que transcribe pero no puede escribir en la ventana que tengas delante. Es una incidencia abierta desde marzo y estos son los pasos que da el propio mantenedor:
- Abre Ajustes del Sistema → Privacidad y seguridad → Accesibilidad.
- Busca OpenWhispr, y también cualquier entrada llamada «Electron», y quítalas con el botón −.
- Vuelve a añadir OpenWhispr con el botón +, desde la carpeta Aplicaciones.
- Comprueba que el interruptor queda activado.
- Reinicia OpenWhispr.
Arrastra la aplicación a la carpeta Aplicaciones antes de abrirla por primera vez. Si se ejecuta desde el disco del .dmg montado, macOS asocia el permiso a una ruta que desaparece y el problema vuelve.
MAC-02 Comportamiento esperado
«No se puede verificar el desarrollador»
El programa no está firmado con un certificado de pago, así que la primera vez macOS lo bloquea. Se resuelve con clic derecho sobre la aplicación → «Abrir», o autorizándola en Ajustes del Sistema → Privacidad y seguridad.
No es señal de que el binario sea sospechoso: firmar cuesta dinero y muchos proyectos libres no lo hacen.
MAC-03 Requisito
Tu Mac no llega a la versión mínima
El proyecto pide macOS 12 (Monterey) o posterior para funcionar, y macOS 13.3 (Ventura) o posterior para transcribir en el propio dispositivo. Si tu Mac se queda por debajo de 13.3, el modo local no es una opción y solo queda el de nube.
MAC-04 Incidencia abierta
La tecla Globe o Fn se comporta de forma irregular
En Mac se puede usar la tecla Globe (🌐) o Fn como atajo de dictado, y tiene una ventaja real: en las versiones empaquetadas no exige el permiso de «Monitorización de entrada».
Pero hay casos abiertos de conflicto con atajos del sistema y de combinaciones que responden de forma inconsistente. Si te pasa, usa una combinación normal de teclas.
MAC-05 Incidencia abierta
El ajuste del portapapeles no se respeta
Hay una incidencia abierta con el ajuste de portapapeles en macOS: puede no comportarse como está configurado. Si el contenido del portapapeles te importa, cuenta con que OpenWhispr lo va a sobrescribir al dictar.
MAC-06 Cómo se hace
Desinstalarlo del todo
Borrar la aplicación no borra los modelos, que son lo que ocupa. En macOS hay que quitarlos a mano:
- Modelos: ~/.cache/openwhispr/
- Datos de la aplicación: ~/Library/Application Support/OpenWhispr/
Plataforma 02
Windows
WIN-01 Comportamiento esperado
SmartScreen bloquea el instalador
Por el mismo motivo que en Mac: el instalador no está firmado con un certificado de pago. Aparece el aviso y hay que pulsar «Más información» → «Ejecutar de todas formas». La instalación no pide permisos de administrador.
WIN-02 Diagnóstico
Solo funciona pulsar, no mantener pulsado
Windows sí admite el «mantener pulsado para grabar, soltar para parar», y lo hace con un programa auxiliar propio que se instala con la aplicación (windows-key-listener.exe).
Si ese auxiliar no está disponible, la aplicación cae automáticamente en modo «pulsar para alternar». Eso explica el síntoma de que mantener la tecla no haga nada. Reinstalar suele devolverlo a su sitio.
Admite además combinaciones complejas del tipo Ctrl+Shift+F11.
WIN-03 Cómo funciona
No pega el texto en la terminal
El pegado lo hace otro auxiliar (windows-fast-paste) y es más listo de lo que parece: en programas normales envía Ctrl+V, pero al detectar una terminal envía Ctrl+Shift+V, que es lo que esperan.
Reconoce Windows Terminal, cmd, PowerShell, mintty, PuTTY, Alacritty, WezTerm, kitty, Hyper, MobaXterm y ConEmu. Si tu terminal no está en la lista, el pegado puede fallar y el texto se queda en el portapapeles.
WIN-04 Requisito
No captura el audio del sistema
Para grabar el sonido del propio equipo —y no solo el micrófono— hace falta Windows 10 versión 2004 o posterior. El programa necesita arquitectura x64.
WIN-05 Incidencia abierta
La aceleración por GPU aparece activada pero no hace nada
Hay una incidencia abierta: la interfaz muestra la aceleración por Vulkan como activa cuando en realidad no lo está. Si la transcripción va lenta y cuentas con la GPU, es el primer candidato a mirar.
Con equipos de varias tarjetas hay además trabajo en curso para poder elegir cuál se usa.
WIN-06 Incidencia abierta
Los modelos se descargan donde no toca
La caché de modelos vive en %USERPROFILE%\.cache\openwhispr\. Si has redirigido las carpetas de usuario a otra unidad, ten en cuenta esta incidencia abierta: la caché ignora esa redirección y escribe en la ruta original. Importa cuando el disco del sistema va justo.
Plataforma 03
Linux
LNX-01 Falta una herramienta
Transcribe pero no pega el texto
El pegado lo hace un auxiliar propio (linux-fast-paste) que cubre X11 y Wayland. Cuando no está disponible hacen falta las herramientas del sistema:
- X11: xdotool.
- Wayland: wtype, o ydotool —que además necesita su demonio en marcha—.
Sin ninguna de ellas la transcripción se hace igual y el texto queda en el portapapeles.
En GNOME con Wayland hay una incidencia abierta de pegado que falla en silencio, sin avisar de nada.
LNX-02 No soportado
El «mantener pulsado» no existe aquí
Es la diferencia más importante respecto a los otros dos sistemas, y conviene decirla sin rodeos: en GNOME el modo de mantener pulsado no está disponible, y en Hyprland tampoco.
No es un fallo de configuración ni algo que se arregle: no está soportado. Se dicta pulsando para empezar y pulsando para terminar.
LNX-03 Según el escritorio
El atajo no se registra
- GNOME: los atajos se registran por D-Bus y gsettings, así que aparecen en los ajustes del sistema. Cuando el atajo normal falla, el de respaldo es F8.
- KDE Plasma: integración nativa por D-Bus, sin más.
- Hyprland: necesita hyprctl —viene incluido— y el atajo se vuelve a registrar en cada arranque, así que tiene que estar accesible en el PATH.
LNX-04 Resuelto: actualiza
Errores de la transcripción local
Es el hilo más largo de todo el repositorio: los errores de Whisper local en Linux acumulan 32 comentarios y están resueltos. Así que lo primero es actualizar a la última versión antes de investigar nada.
Para el audio hace falta PulseAudio o PipeWire. La arquitectura soportada es x64: el soporte de ARM (aarch64) está planificado pero no disponible.
LNX-05 Cómo se hace
Qué formato instalar, y qué deja atrás al desinstalar
- .deb — Debian, Ubuntu, Mint, Pop!_OS
- .rpm — Fedora, RHEL, openSUSE
- .AppImage — cualquier distribución, sin instalar nada
- .tar.gz — universal
Al desinstalar, .deb y .rpm se llevan la caché de modelos; con AppImage y tar.gz hay que borrar ~/.cache/openwhispr/ a mano.
Si nada de esto lo arregla
Este sitio no es el soporte del proyecto y no puede resolver casos concretos. Cuando el problema no está en esta página, el lugar correcto es el registro de incidencias, en inglés, donde responden los propios autores.
Busca primero si ya está reportada —varias de las de esta página lo estaban— y di siempre tres cosas: la versión de OpenWhispr, el sistema y su versión, y si usas transcripción local o en la nube.
Sitio no oficial.
Esta web es una guía independiente en español y no está afiliada al proyecto OpenWhispr ni a sus autores. OpenWhispr es marca de sus respectivos titulares y se publica con licencia MIT. El sitio oficial es openwhispr.com y el código está en GitHub.