Configuración inicial

Asume que Instalación y permisos ya está hecho. Las figuras son vistas previas de la UI de ajustes (public/screenshots/setup-*.webp).

Resumen

Paso	Dónde	Objetivo
1	Barra de menú → Ajustes	Abrir la UI principal
2	General	Desactivar el modo demo para escritura por voz real
3	Modelos de escritura por voz	Elegir un motor y clave si hace falta
4	Atajo	Confirmar escritura por voz ⌃⌥Space y comando ⌃⌥C (reasignables)
5	Procesamiento de texto	Espaciado / pulido (los valores por defecto están bien)
6	Notas, etc.	Prueba de extremo a extremo

1. Abrir Ajustes

1. Haz clic en el icono de VoiceHotkey en la barra de menú.
2. Elige Ajustes.
3. Grupos de la barra lateral:
   • App: General, Acerca de, Licencia
   • Voz: Atajos, Modelos de escritura por voz, Procesamiento de texto, Comandos de voz
   • Herramientas: Transcripción de archivos, Historial

Fig. 1 · Ajustes (vista previa · setup-01-settings.webp)

Deeplink

voicehotkey://tab/settings — ver Deeplinks.

2. Modo demo

El modo demo omite el micrófono y usa texto de demostración para que explores la UI. Desactívalo para la escritura por voz real.

1. Abre Ajustes → General.
2. Busca Modo demo.
3. Para escribir de verdad: desactívalo.
4. El estado de la barra de menú debería dejar de indicar demo / mic no usado; corrige a continuación avisos de micrófono o del motor.

Fig. 2 · General · Modo demo (vista previa · setup-02-demo.webp)

Cuándo dejar el demo activo

Solo para explorar la UI, sin grabar. La transcripción de archivos también puede omitir subidas reales en modo demo.

3. Elegir un modelo de escritura por voz

1. Abre Ajustes → Modelos de escritura por voz.
2. Elige un motor, p. ej.:
   • Apple (en el dispositivo; buen camino para el primer éxito)
   • Doubao y otros (consulta Planes para límites Free)
   • Bailian / MiMo / OpenAI Speech / Groq / Soniox / NVIDIA… (varios motores en Trial/Pro)
3. Motores en la nube: pega una API key (se guarda en el Keychain).
4. Completa el id del modelo, idioma y términos de contexto según haga falta.
5. Confirma que no haya errores de “not configured” en la página.

Fig. 3 · Modelos de escritura por voz (vista previa · setup-03-models.webp)

Camino más rápido

Empieza con Apple o un motor en la nube para el que ya tengas clave. Detalles: Modelos de escritura por voz.

Modo Solo local

Si Solo local está activo, los motores de nube pública fallan. Usa Apple, los cuatro motores en dispositivo (SenseVoice / Whisper Turbo / Fun-ASR-Nano / Parakeet) / localhost, o desactiva Solo local temporalmente.

4. Confirmar atajos

1. Abre Ajustes → Atajos.
2. Busca Escritura por voz — suele ser ⌃⌥Space; comando de voz es ⌃⌥C.
3. Tocar alterna la grabación; mantener habla hasta soltar (según el modo de activación).
4. Si hay conflicto, graba otra combinación.
5. Opcional: vincula comando de voz, traducción por voz y escritura por voz directa (omite el pulido; sin atajo por defecto) más adelante.
6. Si la página advierte sobre Accesibilidad, termina Instalación y permisos.

Fig. 4 · Atajos (vista previa · setup-04-hotkeys.webp)

Quick Send, cancelar con Esc y los sonidos viven principalmente en General. Ver Atajos y grabación.

5. Procesamiento de texto (los valores por defecto están bien)

Opción	Primer uso
Strip trailing period	Útil para chat
Smart spacing / paragraphs	Los valores por defecto bastan
Sustituciones de palabras	Agrégalas cuando tengas errores fijos
Pulido con LLM	Necesita clave LLM; más adelante
Acción de salida	Por defecto: insertar en el cursor
Traducción	Atajo y modelo separados

Fig. 5 · Procesamiento de texto (vista previa · setup-05-postprocess.webp)

6. Prueba de extremo a extremo

1. Abre Notas o cualquier campo de texto y haz clic para que el cursor parpadee.
2. Pulsa tu atajo de escritura por voz (el overlay / estado debería cambiar).
3. Di una frase corta.
4. Toca de nuevo o suelta el mantener para terminar.
5. Espera el ASR (y el pulido opcional); el texto debería aparecer en el cursor.
6. Opcional: revisa Historial para una entrada nueva.

Fig. 6 · Probar la escritura por voz (vista previa · setup-06-try.webp)

Criterios de éxito

• Retroalimentación de grabación
• El texto aparece tras soltar
• El texto cae en el campo enfocado

Si falla

Síntoma	Ir a
El atajo no responde	Solución de problemas · atajo
Graba pero no hay texto	Solución de problemas · sin texto
Los permisos se resetean	Solución de problemas · permisos

Después de la configuración

Sustituciones de palabrasCorrige marcas y errores habituales del ASR.

Modo Solo localBloquea Internet pública.

Comandos de vozAtajos hablados opcionales.