Ayuda | Soffio

Primer uso

Abre la imagen de disco y arrastra Soffio a tu carpeta Aplicaciones. Ábrelo desde ahí.
Soffio descarga su modelo de voz una vez (unos 613 MB). Deja la app abierta hasta que termine. A partir de ahí, el dictado funciona sin conexión.
Concede los permisos de abajo cuando Soffio te los pida. Puedes revisarlos cuando quieras en Soffio, en Ajustes > Permisos.
Haz clic en cualquier campo de texto, pulsa Fn, habla y vuelve a pulsar Fn. Para cancelar, pulsa Esc.

Tu prueba de 14 días empieza con tu primer dictado.

Permisos

macOS guarda estos interruptores en Ajustes del Sistema > Privacidad y seguridad. Soffio necesita los tres primeros. El cuarto es opcional.

Permisos que pide Soffio
Permiso	Por qué lo necesita Soffio
Micrófono	Para oírte mientras dictas. El audio solo se graba mientras se ve la barra. Sin él, no hay nada que transcribir.
Accesibilidad	Para detectar tu tecla de dictado y pegar el texto en la app que estás usando, igual que si pulsaras `⌘V`.
Monitorización de entrada	Para notar la tecla de dictado mientras otra app está delante. Soffio solo busca sus propias teclas y no graba ni envía lo que escribes.
Automatización	Opcional. Solo para que Soffio pueda pausar Spotify o Música mientras dictas. Si lo rechazas, todo lo demás funciona.

Si un permiso no se mantiene

Abre la lista correspondiente en Ajustes del Sistema y desactiva Soffio; luego actívalo de nuevo. Si la entrada parece atascada, selecciónala, haz clic en el botón menos y vuelve a añadir Soffio con el botón más.
Sal de Soffio desde su icono de la barra de menús y vuelve a abrirlo. macOS solo aplica Accesibilidad y Monitorización de entrada tras reiniciar la app.
¿Sigue sin funcionar? Restablece las entradas y vuelve a concederlas. En Terminal:
```
tccutil reset All com.robertocinetto.soffio
```

La tecla Fn (🌐)

En la mayoría de los Mac, la tecla Fn es también la tecla 🌐, y macOS puede usarla para otra cosa, como el selector de emojis o el dictado de Apple. En ese caso, Soffio no la ve. Cámbialo una vez:

Abre Ajustes del Sistema > Teclado.
Junto a Pulsar la tecla 🌐 para, elige No hacer nada.

Soffio también te avisa cuando la tecla 🌐 está configurada para otra cosa. Si prefieres no renunciar a la tecla 🌐, elige otro atajo de dictado en Soffio, en Ajustes > Atajos.

Clave de Groq (opcional)

Groq es un servicio en la nube que transcribe la voz. Soffio funciona por completo sin él, y Groq está desactivado hasta que guardas una clave y lo activas. Con tu propia clave, Soffio también puede usar Groq para la transcripción y para los comandos. No pagas nada más a Soffio, y Soffio no añade recargos.

Consigue una clave gratis

Ve a console.groq.com/keys e inicia sesión o crea una cuenta.
Elige Create API Key, ponle cualquier nombre y copia la clave. Groq solo la muestra una vez.
En Soffio, abre Ajustes > Nube e IA, pega la clave y deja que Soffio la pruebe. Se guarda en el Llavero de macOS. Después, Soffio te pregunta si quieres usar Groq ahora y te avisa de que las grabaciones irán a Groq. Si dices que no, no se envía nada.

Groq ofrece un plan gratuito con límites de uso. Groq decide sus límites y condiciones, así que consúltalos en su web.

Qué se envía

Nada mientras Groq está desactivado o no tiene clave.
Con la transcripción en la nube activada: cada grabación y las palabras de tu diccionario van a Groq, a api.groq.com. Puedes desactivar la transcripción en la nube y conservar la clave.
Con el formato con IA activado: el texto dictado, las palabras de tu diccionario y el prompt de estilo de la app.
Los comandos usan Groq en cuanto activas Groq, y tienen su propio interruptor de Groq en Ajustes > Comandos. Con Groq envían el texto seleccionado y tu instrucción hablada. Con Ollama en tu Mac, nada sale de él.
La clave en sí solo va a Groq.

Para dejar de usar Groq, borra la clave en Ajustes > Nube e IA, o revócala en la consola de Groq.

Línea de comandos, enlaces y agentes

Soffio incluye un comando soffio y un servidor MCP para que Claude Code, otros agentes y scripts puedan usar tu diccionario, tus snippets y tus estadísticas. Ambos están desactivados por defecto.

Para instalar el comando, elige Instalar la herramienta de línea de comandos en el menú de Soffio. Crea el enlace ~/.local/bin/soffio. Si tu shell no lo encuentra, añade ~/.local/bin a tu PATH. Ejecuta soffio help en Terminal para ver todos los comandos.
Para que las herramientas lean el historial, activa Ajustes > General > Automatización > Permitir que los agentes lean el historial.
Para que los agentes y la línea de comandos inicien y detengan el dictado, activa Permitir que agentes y la línea de comandos controlen el dictado en el mismo sitio. Para los enlaces, activa Permitir que los enlaces controlen el dictado. Ambos están desactivados por defecto.
El comando habla con la app en marcha a través de un archivo privado que solo tu usuario puede abrir. Nada pasa por la red.

Enlaces soffio://

Soffio responde a los enlaces soffio://. soffio://dictate/start y soffio://dictate/stop inician y detienen el dictado, y solo funcionan si Permitir que los enlaces controlen el dictado está activado. soffio://licence/TU-CLAVE abre Ajustes > Licencia con tu clave ya escrita. Nunca activa nada por sí solo: el botón lo pulsas tú.

Solución de problemas

No pasa nada al pulsar Fn

Revisa el ajuste de la tecla 🌐.
Revisa Accesibilidad y Monitorización de entrada en Ajustes > Permisos. Mira si un permiso no se mantiene.
Puede que otra app tenga activada la entrada segura, por ejemplo un campo de contraseña seleccionado. Haz clic fuera de él y vuelve a intentarlo.

El texto no se ha pegado

Algunos campos, como los de contraseña, rechazan el texto pegado. El dictado no se pierde. Está en el historial, y Copiar último dictado en la barra de menús lo pone en el portapapeles.

No hay sonido, o el micrófono no es el correcto

Elige la entrada correcta en Ajustes > Dictado. Soffio también ofrece Cambiar de micrófono cuando no oye nada. Comprueba que Soffio está activado en Micrófono, en Ajustes del Sistema.

Una VPN da un error 403 y Soffio pasa al motor local

Groq bloquea algunas VPN y redes compartidas, y responde con un error 403. Soffio usa entonces al momento el motor local, muestra un breve aviso y vuelve a probar Groq al cabo de 30 segundos, luego de 2 minutos y después cada 5 minutos. No se pierde nada y el dictado sigue funcionando. Para volver a usar la nube, desactiva la VPN o excluye api.groq.com. Para que no salga el aviso, desactiva la transcripción en la nube en Ajustes > Nube e IA.

El modelo de voz no se descarga

Comprueba tu conexión a internet y desactiva un momento cualquier VPN, proxy o filtro de contenido.
Asegúrate de que el Mac tiene al menos 2 GB libres.
Sal de Soffio, borra la carpeta ~/Library/Application Support/Soffio/Models y vuelve a abrir Soffio. La descarga empieza de nuevo desde el principio.
¿Sigue fallando? Escribe a soporte y di qué pone el aviso.

macOS dice que la app no se puede abrir

Soffio está firmado y notarizado, así que no debería pasar. Vuelve a descargar la imagen de disco de esta web y compara su suma de comprobación con la de la sección de descarga. Ejecuta shasum -a 256 y arrastra el archivo a Terminal. Si sigue fallando, escribe a soporte.

El dictado va lento

En tu Mac, el texto suele llegar unos 125 ms después de soltar la tecla (mediana), y en 100 a 300 ms con la nube. El primer dictado tras un rato largo de inactividad puede tardar un poco más. Los dictados largos también tardan más. Si siempre va lento, comprueba que la transcripción en la nube solo esté activada si la quieres y que ninguna VPN esté ralentizando Groq.

Licencia

Una licencia es para una persona en hasta 3 Mac. La prueba dura 14 días desde tu primer dictado, sin tarjeta. Tu clave de licencia llega en el correo de Polar después de la compra.

Introduce tu clave

Abre Ajustes > Licencia y elige Introducir licencia. También puedes hacer clic en el enlace soffio://licence/… del correo de compra, que abre el mismo sitio con la clave ya escrita.
Pega la clave y pulsa el botón para activarla. Soffio necesita internet para este paso. Después, el Mac ocupa una de tus 3 plazas.

Restaurar en un Mac nuevo o tras reinstalar

Instala Soffio y vuelve a introducir la misma clave. Tu historial y tus ajustes vuelven si conservaste la carpeta de datos. ¿Has perdido la clave? Abre el correo de Polar, búscala en el portal de clientes de Polar con la dirección con la que compraste, o escribe a soporte.

Desactivar un Mac

En Ajustes > Licencia, elige Desactivar este Mac. Así liberas la plaza y puedes usar la clave en otro sitio. Hazlo antes de vender o borrar un Mac. Gestionar Macs abre el portal de clientes, donde puedes quitar un Mac al que ya no tienes acceso. Si las 3 plazas están ocupadas, Soffio te lo dice.

Uso sin conexión

La prueba funciona sin conexión y no envía nada.
Tras la activación, Soffio comprueba tu licencia en segundo plano más o menos una vez por semana, nunca mientras dictas.
Si una comprobación falla porque no tienes conexión, estás tras una VPN o el servicio no responde, no cambia nada. Durante 30 días no se muestra nada. Después verás una nota discreta para que te conectes una vez, y Soffio sigue funcionando.
Una licencia solo deja de funcionar cuando Polar indica claramente que se ha reembolsado, revocado o ha caducado, en dos comprobaciones separadas por al menos 7 días.

Cuando termina la prueba

El dictado y los comandos se detienen. Historial, Diccionario, Snippets y Ajustes siguen abiertos y puedes exportarlos. No se borra nada. Introduce una licencia y el dictado vuelve a funcionar.

Actualizaciones

Soffio busca actualizaciones por sí solo y pregunta antes de instalar una. También puedes elegir Buscar actualizaciones en el menú de Soffio. Las actualizaciones de la versión 1 son gratis.
La comprobación descarga un archivo pequeño y no envía datos personales. Puedes desactivarla en Ajustes.

Informes de fallos y diagnóstico

Soffio nunca envía un informe de fallo por su cuenta, y no tiene analíticas.

Tras un fallo, Soffio puede ofrecerte enviar el informe la próxima vez que lo abras. Puedes leerlo antes. El nombre de tu carpeta de inicio se sustituye por ~. Enviar por correo abre un correo a support@getsoffio.app con el archivo adjunto, y lo envías tú desde tu app de correo. Si eliges no enviarlo, nada sale de tu Mac.
Copiar diagnóstico pone un breve resumen en el portapapeles: las versiones de Soffio y de macOS y el modelo de tu Mac. Pégalo en un correo a soporte, o donde quieras. No contiene texto dictado.
Un informe de fallo es técnico. No debería contener tus dictados, pero léelo antes de enviarlo.

Desinstalar

Primero sal de Soffio. Después quita lo que quieras quitar. Si solo borras la app, tus datos se quedan donde están, y una reinstalación posterior los vuelve a encontrar.

La app

Arrastra Soffio.app de Aplicaciones a la Papelera.
Quítalo de Ajustes del Sistema > General > Ítems de inicio si lo tenías configurado para abrirse al iniciar sesión.

Lo que Soffio guarda en tu Mac

Archivos y ajustes que crea Soffio
Dónde	Qué contiene
`~/Library/Application Support/Soffio/`	Tu historial, diccionario, snippets y estadísticas (`Soffio.store`), las grabaciones guardadas (`Recordings`, 14 días por defecto; puedes cambiarlo en Ajustes > General), registros con solo cifras de tiempo y sin texto dictado (`Logs`), el modelo de voz (`Models`, unos 613 MB), una copia del inicio de tu prueba y el archivo de socket para los agentes.
`~/Library/Preferences/com.robertocinetto.soffio.plist`	Tus ajustes.
`~/Library/Caches/com.robertocinetto.soffio`	Archivos temporales.
Llavero, en la app Acceso a Llaveros	Tu clave de Groq y tu licencia, si las introdujiste. Busca `com.robertocinetto.soffio`.
`~/.local/bin/soffio`	Enlaces de la herramienta de línea de comandos, si estaba instalada.
`~/Library/Logs/DiagnosticReports/`	Informes de fallos que macOS escribió para Soffio (`Soffio-*.ips`), si alguna vez falló. Bórralos si quieres.
Privacidad y seguridad	Las entradas de permisos. Para borrarlas: `tccutil reset All com.robertocinetto.soffio`

Para quitarlo todo de una vez, copia esto en Terminal después de salir de Soffio y llevar la app a la Papelera. Esto borra tu historial para siempre, así que exporta antes lo que necesites.

rm -rf "$HOME/Library/Application Support/Soffio" \
       "$HOME/Library/Caches/com.robertocinetto.soffio" \
       "$HOME/Library/Preferences/com.robertocinetto.soffio.plist" \
       "$HOME/.local/bin/soffio"
tccutil reset All com.robertocinetto.soffio

Antes de desinstalarlo para siempre, elige Desactivar este Mac en Ajustes > Licencia para liberar la plaza. Si no, quita el Mac en el portal de clientes de Polar, o escribe a soporte y la liberamos nosotros. El comando de arriba no quita los elementos del Llavero de tu licencia y tu clave de Groq: bórralos en Acceso a Llaveros.

Todo lo que necesitas para empezar.