Dictto

Voz a texto para macOS — Dictado por voz en todo el sistema, potenciado por Groq Whisper AI.

Presiona un atajo de teclado en cualquier lugar de tu Mac, habla, y tus palabras aparecen como texto donde esta tu cursor. Sin necesidad de escribir.

Caracteristicas

• Atajos globales: Manten presionado Ctrl+Option (push-to-talk) o doble-tap Shift (manos libres)
• Transcripcion instantanea: Latencia menor a 1 segundo via Groq Whisper API
• Auto-pegado: El texto aparece donde esta tu cursor — cualquier app, cualquier campo
• Optimizado para espanol: Configurado para espanol con soporte de diccionario personalizado
• Dashboard web: Historial, busqueda y gestion de diccionario en localhost:5050
• App de menu bar: Se ejecuta silenciosamente en tu barra de menu, sin icono en el Dock
• Anti-alucinaciones: Sistema de filtrado de 4 capas que previene artefactos de Whisper

Requisitos

• macOS 13.0 o posterior (Apple Silicon o Intel)
• API Key de Groq (disponible en console.groq.com/keys)

Instalacion

1. Descargar

Descarga el archivo .dmg mas reciente desde Releases.

2. Instalar

Abre el DMG y arrastra Dictto a tu carpeta de Aplicaciones.

3. Abrir por primera vez

Dictto es de distribucion directa y no esta notarizada por Apple, asi que al descargarla macOS la marca con "cuarentena". En macOS 15 (Sequoia) y posteriores esto provoca varias advertencias seguidas del tipo "Apple no pudo verificar que esta libre de malware" — una por cada componente interno. Para quitar la cuarentena de una sola vez:

1. Abre la app Terminal (Aplicaciones > Utilidades)

2. Pega este comando y presiona Enter:

   xattr -cr /Applications/Dictto.app
   

3. Abre Dictto normalmente desde Aplicaciones

Solo necesitas hacer esto una vez.

En versiones mas antiguas de macOS suele bastar con click derecho sobre Dictto > Abrir > Abrir. Si igual te salen multiples advertencias, usa el comando de arriba.

4. Ingresar API Key

Al abrir Dictto por primera vez, aparecera un cuadro de dialogo pidiendo tu API Key de Groq:

1. Ve a console.groq.com/keys y crea una key (es gratis)
2. Copia la key (empieza con gsk_...)
3. Pegala en el dialogo de Dictto y haz click en Continuar

La key se guarda automaticamente. No necesitas ingresarla de nuevo.

5. Otorgar permisos

Dictto necesita tres permisos de macOS para funcionar. La app intentara solicitarlos automaticamente, pero si no aparecen los dialogos, puedes otorgarlos manualmente:

Accesibilidad (obligatorio)

Permite que Dictto pegue texto en cualquier app.

• La app muestra el dialogo automaticamente al abrir
• Manual: Ajustes del Sistema > Privacidad y Seguridad > Accesibilidad > activa Dictto

Microfono (obligatorio)

Permite que Dictto capture tu voz.

• macOS pide permiso la primera vez que grabas
• Manual: Ajustes del Sistema > Privacidad y Seguridad > Microfono > activa Dictto

Input Monitoring (obligatorio)

Permite que Dictto detecte los atajos de teclado (Ctrl+Option, Shift).

• macOS puede pedirlo automaticamente o no, depende de la version
• Manual: Ajustes del Sistema > Privacidad y Seguridad > Input Monitoring > activa Dictto

Nota: Despues de otorgar permisos en Ajustes del Sistema, puede que necesites cerrar y volver a abrir Dictto para que los cambios surtan efecto.

Como usar

Modos de grabacion

Modo	Teclas	Descripcion
Push-to-talk	Manten Ctrl + Option	Graba mientras mantienes presionado. Suelta para transcribir.
Manos libres	Doble-tap Shift	Empieza a grabar. Toca Shift una vez mas para detener.
Cancelar	Escape	Cancela cualquier grabacion activa.

Flujo de uso

1. Coloca tu cursor donde quieras que aparezca el texto (cualquier app)
2. Presiona Ctrl+Option (mantener) o doble-tap Shift
3. Habla normalmente en espanol
4. Suelta las teclas (o toca Shift para detener)
5. El texto transcrito aparece automaticamente donde esta tu cursor

Dashboard

Haz click en el icono de Dictto en la barra de menu para abrir el dashboard en tu navegador (http://localhost:5050).

Desde el dashboard puedes:

• Ver el historial de transcripciones
• Buscar en transcripciones anteriores
• Agregar o eliminar terminos del diccionario personalizado

Diccionario personalizado

El diccionario ayuda a Whisper a reconocer palabras tecnicas, nombres de apps, o terminos especificos de tu trabajo. Puedes gestionarlo desde el dashboard.

Solucion de problemas

Problema	Solucion
"No se puede abrir la app" / "Apple no pudo verificar... malware"	Abre Terminal y ejecuta xattr -cr /Applications/Dictto.app, luego abre Dictto
Los atajos no funcionan	Ajustes del Sistema > Privacidad y Seguridad > Accesibilidad > activa Dictto. Tambien verifica Input Monitoring.
No captura audio	Ajustes del Sistema > Privacidad y Seguridad > Microfono > activa Dictto
El texto no se pega	Asegurate de que Dictto tenga permiso de Accesibilidad activado
Dashboard no carga	Espera unos segundos despues de abrir la app, luego visita http://localhost:5050
La app no aparece	Busca el icono de Dictto en la barra de menu (parte superior derecha de la pantalla)
Permisos no se solicitan	Otorgalos manualmente en Ajustes del Sistema > Privacidad y Seguridad (ver seccion de permisos arriba)
Transcripcion lenta	Verifica tu conexion a internet. Dictto usa la API de Groq en la nube.

Soporte

Reporta errores o problemas en la pestana de Issues de este repositorio.

---

Desarrollado por Juan Lara