Configuración inicial

Asume que Instalación y permisos ya está hecho. Los marcos discontinuos son marcadores de captura (public/screenshots/setup-*.svg).

Resumen

Paso	Dónde	Objetivo
1	Barra de menú → Ajustes	Abrir la UI principal
2	General	Desactivar el modo demo para dictado real
3	Modelos de dictado	Elegir un motor y clave si hace falta
4	Atajo	Confirmar dictado ⌃⌥Space y comando ⌥Space (reasignables)
5	Post-proceso 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 Settings.
3. Grupos de la barra lateral:
   • App: General, About, License
   • Voice: Hotkey, Dictation models, Text post-process, Voice commands
   • Tools: Transcribe files, History

Fig. 1 · Ajustes (marcador · setup-01-settings.svg)

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 el dictado real.

1. Abre Settings → General.
2. Busca Demo mode.
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 · Demo mode (marcador · setup-02-demo.svg)

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 dictado

1. Abre Settings → Dictation models.
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)
   • Whisper / 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 · Dictation models (marcador · setup-03-models.svg)

Camino más rápido

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

Modo Solo local

Si Solo local está activo, los motores de nube pública fallan. Usa Apple / localhost, o desactiva Solo local temporalmente.

4. Confirmar atajos

1. Abre Settings → Hotkey.
2. Busca Voice typing — el dictado suele ser ⌃⌥Space; comando de voz es ⌥Space.
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 Voice command y Voice translation más adelante.
6. Si la página advierte sobre Accesibilidad, termina Instalación y permisos.

Fig. 4 · Hotkeys (marcador · setup-04-hotkeys.svg)

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

5. Post-proceso 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 · Text post-process (marcador · setup-05-postprocess.svg)

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 voice typing (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 History para una entrada nueva.

Fig. 6 · Probar el dictado (marcador · setup-06-try.svg)

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.