Instalación y permisos

Tras la instalación y con los permisos correctos, los atajos globales y el dictado se mantienen fiables. Los marcos discontinuos son marcadores de captura — sustituye los SVG en public/screenshots/ por capturas reales cuando estén listas.

Requisitos

• macOS 14 o posterior
• Apple Silicon o Intel
• Opcional: claves API (BYOK) de ASR / LLM
• El dictado real necesita: Micrófono + Accesibilidad

1. Descargar el instalador

1. Abrir Releases
   Ve a VoiceHotkey-releases · Latest.

2. Descargar el DMG
   Elige el archivo .dmg de macOS. No uses los archivos Source code como la app.

3. Abrir la imagen de disco
   Haz doble clic en el DMG y espera a la ventana de instalación.

Fig. 1 · Página de Releases (marcador · install-01-releases.svg)

2. Instalar en una ruta estable

1. Arrastrar a Aplicaciones
   Arrastra VoiceHotkey.app a Aplicaciones, o a ~/Applications.

2. Expulsar el DMG (opcional)
   Puedes guardar el DMG como respaldo si lo prefieres.

3. Recordar la ruta
   Siempre inicia desde la misma ubicación, p. ej.

   • /Applications/VoiceHotkey.app
   • o ~/Applications/VoiceHotkey.app

Fig. 2 · Ventana de instalación del DMG (marcador · install-02-dmg.svg)

Fig. 3 · Confirmar la ruta de la app (marcador · install-03-path.svg)

No ejecutes a largo plazo desde Descargas

Iniciar desde ~/Downloads o una carpeta temporal hace que macOS trate Accesibilidad como otra app tras mover o volver a descargar — los atajos dejan de funcionar “al azar”. Instala primero en Aplicaciones y luego concede el acceso.

3. Primer inicio

1. Abrir la app
   Desde Launchpad o el Finder. Si Gatekeeper la bloquea, permítela en Privacidad y seguridad (las builds notarizadas van más fluidas).

2. Comprobar la barra de menú
   Debe aparecer un icono tipo micrófono a la derecha. Si falta, revisa el desbordamiento de la barra de menú o que la app siga en ejecución.

3. Completar el onboarding
   El primer inicio muestra Configuración rápida (bienvenida → permisos → plan → listo). Puedes conceder el acceso ahí o después en Ajustes del Sistema.

Fig. 4 · Icono de la barra de menú (marcador · install-07-menubar.svg)

Fig. 5 · Permisos del onboarding (marcador · install-06-onboarding.svg)

4. Conceder Accesibilidad

Necesario para atajos globales, insertar texto en el cursor e inyección de teclas. Sin esto, el atajo normalmente no hace nada.

1. Abre Ajustes del Sistema → Privacidad y seguridad → Accesibilidad.
2. Haz clic en + (o desbloquea) y agrega VoiceHotkey.app.
3. Confirma que la ruta coincide con la app que realmente ejecutas.
4. Activa el interruptor.
5. Si ves varias filas de “VoiceHotkey”: elimina las antiguas, deja solo la ruta actual, luego cierra y vuelve a abrir la app.

Fig. 6 · Accesibilidad (marcador · install-04-accessibility.svg)

Abrir desde la app

Ajustes → General (o el onboarding) suele tener un botón que salta a Accesibilidad. Tras conceder, la barra de menú debería dejar de advertir “Need Accessibility”.

5. Conceder Micrófono

Obligatorio para el dictado real. El modo demo puede omitir el micrófono; el uso en producción lo necesita.

1. Abre Ajustes del Sistema → Privacidad y seguridad → Micrófono.
2. Activa VoiceHotkey.
3. Acepta el aviso del sistema en la primera grabación si aparece.
4. Con micrófonos externos, revisa Ajustes del Sistema → Sonido → Entrada. Usa el mismo dispositivo en General de la app si se muestra un selector de micrófono.

Fig. 7 · Micrófono (marcador · install-05-microphone.svg)

6. Lista de comprobación de permisos

Comprobar	Esperado
Icono de la barra de menú	Visible, el menú se abre
Ajustes → General · permisos	Accesibilidad + micrófono concedidos
Pulsar el atajo	Overlay / cambio de estado (incluso en demo)
Ruta de instalación	Coincide con la entrada de Accesibilidad

¿Sigue fallando? Consulta Solución de problemas.

Siguiente

Configuración inicialModo demo, motor, atajos y una prueba real de escritura.

Atajos y grabaciónToque / mantener, Quick Send, cancelar.