Aide | Soffio

Premier lancement

Ouvrez l’image disque et faites glisser Soffio dans votre dossier Applications. Ouvrez-le depuis là.
Soffio télécharge son modèle vocal une fois (environ 613 Mo). Laissez l’app ouverte jusqu’à la fin. Ensuite, la dictée fonctionne hors ligne.
Accordez les autorisations ci-dessous quand Soffio les demande. Vous pouvez les vérifier à tout moment dans Soffio, sous Réglages > Autorisations.
Cliquez dans un champ de texte, appuyez sur Fn, parlez, puis appuyez à nouveau sur Fn. Pour annuler, appuyez plutôt sur Échap.

Votre essai de 14 jours commence avec votre première dictée.

Autorisations

macOS regroupe ces options dans Réglages Système > Confidentialité et sécurité. Soffio a besoin des trois premières. La quatrième est facultative.

Les autorisations que Soffio demande
Autorisation	Pourquoi Soffio en a besoin
Micro	Pour vous entendre pendant que vous dictez. L’audio n’est enregistré que tant que la pastille est affichée. Sans cela, il n’y a rien à transcrire.
Accessibilité	Pour détecter votre touche de dictée et coller le texte dans l’app que vous utilisez, comme si vous appuyiez sur `⌘V`.
Surveillance de l’entrée	Pour repérer la touche de dictée quand une autre app est au premier plan. Soffio ne cherche que ses propres touches et n’enregistre ni n’envoie ce que vous tapez.
Automatisation	Facultatif. Uniquement pour que Soffio puisse mettre Spotify ou Musique en pause pendant que vous dictez. Si vous refusez, tout le reste fonctionne.

Si une autorisation ne tient pas

Ouvrez la liste correspondante dans Réglages Système, désactivez Soffio puis réactivez-le. Si l’entrée semble bloquée, sélectionnez-la, cliquez sur le bouton moins et ajoutez à nouveau Soffio avec le bouton plus.
Quittez Soffio depuis son icône dans la barre des menus et rouvrez-le. macOS n’applique Accessibilité et Surveillance de l’entrée qu’après un redémarrage de l’app.
Toujours bloqué ? Réinitialisez les entrées et accordez-les à nouveau. Dans Terminal :
```
tccutil reset All com.robertocinetto.soffio
```

La touche Fn (🌐)

Sur la plupart des Mac, la touche Fn sert aussi de touche 🌐, et macOS peut l’utiliser pour autre chose, comme le sélecteur d’emoji ou la dictée d’Apple. Dans ce cas, Soffio ne la voit pas. Changez-le une fois :

Ouvrez Réglages Système > Clavier.
À côté de Appuyer sur la touche 🌐 pour, choisissez Ne rien faire.

Soffio vous prévient aussi quand la touche 🌐 est réglée sur autre chose. Si vous préférez garder la touche 🌐, choisissez un autre raccourci de dictée dans Soffio, sous Réglages > Raccourcis clavier.

Clé Groq (facultative)

Groq est un service cloud qui transcrit la voix. Soffio fonctionne entièrement sans lui, et Groq reste désactivé tant que vous n’enregistrez pas une clé et ne l’activez pas. Avec votre propre clé, Soffio peut aussi utiliser Groq pour la transcription et pour les commandes. Vous ne payez rien de plus à Soffio, et Soffio n’ajoute aucune marge.

Obtenir une clé gratuite

Allez sur console.groq.com/keys et connectez-vous ou créez un compte.
Choisissez Create API Key, donnez-lui un nom et copiez la clé. Groq ne l’affiche qu’une fois.
Dans Soffio, ouvrez Réglages > Cloud et IA, collez la clé et laissez Soffio la tester. Elle est enregistrée dans le trousseau de macOS. Soffio vous demande ensuite s’il faut utiliser Groq maintenant, et vous indique que les enregistrements iront à Groq. Répondez non et rien n’est envoyé.

Groq propose une offre gratuite avec des limites d’utilisation. Groq fixe ses limites et ses conditions : vérifiez-les sur son site.

Ce qui est envoyé

Rien tant que Groq est désactivé ou n’a pas de clé.
Avec la transcription cloud activée : chaque enregistrement et les mots de votre dictionnaire vont à Groq, sur api.groq.com. Vous pouvez désactiver la transcription cloud et garder la clé.
Avec la mise en forme par IA activée : le texte dicté, les mots de votre dictionnaire et la consigne de style de l’app.
Les commandes utilisent Groq dès que vous activez Groq, et ont leur propre option Groq dans Réglages > Commandes. Avec Groq, elles envoient le texte sélectionné et votre consigne orale. Avec Ollama sur votre Mac, rien n’en sort.
Votre clé elle-même ne va qu’à Groq.

Pour ne plus utiliser Groq, supprimez la clé dans Réglages > Cloud et IA, ou révoquez-la dans la console Groq.

Ligne de commande, liens et agents

Soffio inclut une commande soffio et un serveur MCP pour que Claude Code, d’autres agents et des scripts puissent utiliser votre dictionnaire, vos snippets et vos statistiques. Les deux sont désactivés par défaut.

Pour installer la commande, choisissez Installer l’outil en ligne de commande dans le menu Soffio. Cela crée le lien ~/.local/bin/soffio. Si votre shell ne le trouve pas, ajoutez ~/.local/bin à votre PATH. Lancez soffio help dans Terminal pour voir toutes les commandes.
Pour permettre aux outils de lire l’historique, activez Réglages > Général > Automatisation > Laisser les agents lire l’historique.
Pour permettre aux agents et à la ligne de commande de démarrer et d’arrêter la dictée, activez Laisser les agents et la ligne de commande contrôler la dictée au même endroit. Pour les liens, activez Laisser les liens contrôler la dictée. Les deux sont désactivés par défaut.
La commande parle à l’app en cours d’exécution par un fichier privé que seul votre utilisateur peut ouvrir. Rien ne passe par le réseau.

Liens soffio://

Soffio répond aux liens soffio://. soffio://dictate/start et soffio://dictate/stop démarrent et arrêtent la dictée, et ne fonctionnent que si Laisser les liens contrôler la dictée est activé. soffio://licence/VOTRE-CLÉ ouvre Réglages > Licence avec votre clé déjà saisie. Rien ne s’active tout seul : c’est vous qui appuyez sur le bouton.

Dépannage

Rien ne se passe quand j’appuie sur Fn

Vérifiez le réglage de la touche 🌐.
Vérifiez Accessibilité et Surveillance de l’entrée dans Réglages > Autorisations. Voir si une autorisation ne tient pas.
Une autre app a peut-être activé la saisie sécurisée, par exemple un champ de mot de passe actif. Cliquez en dehors et réessayez.

Le texte n’a pas été collé

Certains champs, comme les champs de mot de passe, refusent le texte collé. La dictée n’est pas perdue. Elle est dans l’historique, et Copier la dernière dictée dans la barre des menus la place dans le presse-papiers.

Pas de son, ou le mauvais micro

Choisissez la bonne entrée dans Réglages > Dictée. Soffio propose aussi Changer de micro quand il n’entend aucun son. Vérifiez que Soffio est activé sous Micro dans Réglages Système.

Un VPN renvoie une erreur 403 et Soffio repasse en local

Certains VPN et réseaux partagés sont bloqués par Groq, qui répond par une erreur 403. Soffio utilise alors aussitôt le moteur local, affiche un court avis et réessaie Groq après 30 secondes, puis 2 minutes, puis toutes les 5 minutes. Rien n’est perdu et la dictée continue de fonctionner. Pour réutiliser le cloud, désactivez le VPN ou excluez-en api.groq.com. Pour ne plus voir l’avis, désactivez la transcription cloud dans Réglages > Cloud et IA.

Le modèle vocal ne se télécharge pas

Vérifiez votre connexion internet, et désactivez un moment tout VPN, proxy ou filtre de contenu.
Assurez-vous que le Mac dispose d’au moins 2 Go d’espace libre.
Quittez Soffio, supprimez le dossier ~/Library/Application Support/Soffio/Models et rouvrez Soffio. Le téléchargement reprend depuis le début.
Toujours en échec ? Écrivez à l’assistance en indiquant ce que dit l’avis.

macOS indique que l’app ne peut pas être ouverte

Soffio est signé et notarisé, cela ne devrait donc pas arriver. Téléchargez à nouveau l’image disque depuis ce site et comparez sa somme de contrôle avec celle de la section de téléchargement. Lancez shasum -a 256 et faites glisser le fichier dans Terminal. Si cela échoue encore, écrivez à l’assistance.

La dictée semble lente

Sur votre Mac, le texte arrive en général environ 125 ms après avoir relâché la touche (médiane), et en 100 à 300 ms avec le cloud. La première dictée après une longue inactivité peut prendre un peu plus de temps. Les longues dictées aussi. Si c’est toujours lent, vérifiez que la transcription cloud n’est activée que si vous la voulez et qu’aucun VPN ne ralentit Groq.

Licence

Une licence est destinée à une personne, sur 3 Mac au maximum. L’essai dure 14 jours à partir de votre première dictée, sans carte. Votre clé de licence arrive dans l’e-mail de Polar après l’achat.

Saisir votre clé

Ouvrez Réglages > Licence et choisissez Saisir la licence. Vous pouvez aussi cliquer sur le lien soffio://licence/… de votre e-mail d’achat, qui ouvre le même endroit avec la clé déjà saisie.
Collez la clé et appuyez sur le bouton pour l’activer. Soffio a besoin d’internet pour cette étape. Le Mac occupe ensuite l’une de vos 3 places.

Restaurer sur un nouveau Mac ou après une réinstallation

Installez Soffio, puis saisissez à nouveau la même clé. Votre historique et vos réglages reviennent si vous avez gardé le dossier de données. Clé perdue ? Ouvrez l’e-mail de Polar, cherchez dans le portail client de Polar avec l’adresse utilisée pour l’achat, ou écrivez à l’assistance.

Désactiver un Mac

Dans Réglages > Licence, choisissez Désactiver ce Mac. Cela libère la place pour utiliser la clé ailleurs. Faites-le avant de vendre ou d’effacer un Mac. Gérer les Mac ouvre le portail client, où vous pouvez retirer un Mac auquel vous n’avez plus accès. Si les 3 places sont prises, Soffio vous le dit.

Utilisation hors ligne

L’essai fonctionne hors ligne et n’envoie rien.
Après l’activation, Soffio vérifie votre licence en arrière-plan environ une fois par semaine, jamais pendant que vous dictez.
Si une vérification échoue parce que vous êtes hors ligne, derrière un VPN ou que le service est indisponible, rien ne change. Pendant 30 jours, rien n’est affiché. Ensuite, une note discrète vous invite à vous connecter une fois, et Soffio continue de fonctionner.
Une licence ne s’arrête que lorsque Polar indique clairement qu’elle a été remboursée, révoquée ou qu’elle a expiré, lors de deux vérifications espacées d’au moins 7 jours.

À la fin de l’essai

La dictée et les commandes s’arrêtent. Historique, Dictionnaire, Snippets et Réglages restent ouverts et vous pouvez les exporter. Rien n’est supprimé. Saisissez une licence et la dictée reprend.

Mises à jour

Soffio recherche les mises à jour tout seul et demande avant d’en installer une. Vous pouvez aussi choisir Rechercher des mises à jour dans le menu Soffio. Les mises à jour de la version 1 sont gratuites.
La vérification télécharge un petit fichier et n’envoie aucune donnée personnelle. Vous pouvez la désactiver dans les Réglages.

Rapports de plantage et diagnostic

Soffio n’envoie jamais de rapport de plantage de lui-même, et n’a aucune mesure d’audience.

Après un plantage, Soffio peut proposer d’envoyer le rapport à sa prochaine ouverture. Vous pouvez le lire avant. Le nom de votre dossier de départ est remplacé par ~. Envoyer par e-mail ouvre un e-mail à support@getsoffio.app avec le fichier joint, et c’est vous qui l’envoyez depuis votre app de messagerie. Si vous choisissez de ne pas l’envoyer, rien ne quitte votre Mac.
Copier le diagnostic place un court résumé dans le presse-papiers : les versions de Soffio et de macOS, et le modèle de votre Mac. Collez-le dans un e-mail à l’assistance, ou où vous voulez. Il ne contient aucun texte dicté.
Un rapport de plantage est technique. Il ne devrait pas contenir vos dictées, mais lisez-le avant de l’envoyer.

Désinstaller

Quittez d’abord Soffio. Supprimez ensuite ce que vous voulez supprimer. Supprimer seulement l’app laisse vos données en place : une réinstallation ultérieure les retrouve.

L’app

Faites glisser Soffio.app depuis Applications vers la Corbeille.
Retirez-le de Réglages Système > Général > Ouverture et extensions si vous l’aviez fait démarrer à l’ouverture de session.

Ce que Soffio garde sur votre Mac

Fichiers et réglages créés par Soffio
Où	Ce qu’il contient
`~/Library/Application Support/Soffio/`	Votre historique, dictionnaire, snippets et statistiques (`Soffio.store`), les enregistrements conservés (`Recordings`, 14 jours par défaut ; modifiable dans Réglages > Général), des journaux avec uniquement des mesures de temps et aucun texte dicté (`Logs`), le modèle vocal (`Models`, environ 613 Mo), une copie du début de votre essai et le fichier socket pour les agents.
`~/Library/Preferences/com.robertocinetto.soffio.plist`	Vos réglages.
`~/Library/Caches/com.robertocinetto.soffio`	Fichiers temporaires.
Trousseau, dans l’app Trousseaux d’accès	Votre clé Groq et votre licence, si vous les avez saisies. Cherchez `com.robertocinetto.soffio`.
`~/.local/bin/soffio`	Les liens de l’outil en ligne de commande, s’il était installé.
`~/Library/Logs/DiagnosticReports/`	Les rapports de plantage écrits par macOS pour Soffio (`Soffio-*.ips`), s’il a déjà planté. Supprimez-les si vous le souhaitez.
Confidentialité et sécurité	Les entrées d’autorisation. Pour les effacer : `tccutil reset All com.robertocinetto.soffio`

Pour tout supprimer d’un coup, copiez ceci dans Terminal après avoir quitté Soffio et mis l’app à la Corbeille. Cela supprime définitivement votre historique : exportez d’abord ce dont vous avez besoin.

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

Avant de désinstaller pour de bon, choisissez Désactiver ce Mac dans Réglages > Licence pour libérer la place. Sinon, retirez le Mac dans le portail client de Polar, ou écrivez à l’assistance et nous la libérerons pour vous. La commande ci-dessus ne supprime pas les éléments du trousseau pour votre licence et votre clé Groq : supprimez-les dans Trousseaux d’accès.

Tout ce qu’il faut pour bien démarrer.