Aiuto | Soffio

Primo avvio

Apri l’immagine disco e trascina Soffio nella cartella Applicazioni. Aprilo da lì.
Soffio scarica il suo modello vocale una volta (circa 613 MB). Tieni l’app aperta finché non ha finito. Da lì in poi, la dettatura funziona offline.
Concedi i permessi qui sotto quando Soffio li chiede. Puoi controllarli in qualsiasi momento in Soffio, in Impostazioni > Permessi.
Fai clic in un campo di testo qualsiasi, premi Fn, parla e premi di nuovo Fn. Per annullare, premi invece Esc.

La prova di 14 giorni parte con la tua prima dettatura.

Permessi

macOS tiene questi interruttori in Impostazioni di Sistema > Privacy e sicurezza. A Soffio servono i primi tre. Il quarto è facoltativo.

I permessi che Soffio chiede
Permesso	Perché serve a Soffio
Microfono	Per sentirti mentre detti. L’audio viene registrato solo mentre è visibile la barra. Senza, non c’è niente da trascrivere.
Accessibilità	Per vedere il tuo tasto di dettatura e incollare il testo nell’app che stai usando, come se premessi `⌘V`.
Monitoraggio input	Per accorgersi del tasto di dettatura mentre in primo piano c’è un’altra app. Soffio cerca solo i propri tasti e non registra né invia ciò che scrivi.
Automazione	Facoltativo. Serve solo a mettere in pausa Spotify o Musica mentre detti. Se rifiuti, tutto il resto funziona.

Se un permesso non resta attivo

Apri l’elenco corrispondente in Impostazioni di Sistema e disattiva Soffio, poi riattivalo. Se la voce sembra bloccata, selezionala, fai clic sul pulsante meno e aggiungi di nuovo Soffio con il pulsante più.
Esci da Soffio dalla sua icona nella barra dei menu e riaprilo. macOS applica Accessibilità e Monitoraggio input solo dopo un riavvio dell’app.
Ancora niente? Reimposta le voci e concedile di nuovo. Nel Terminale:
```
tccutil reset All com.robertocinetto.soffio
```

Il tasto Fn (🌐)

Sulla maggior parte dei Mac il tasto Fn è anche il tasto 🌐, e macOS può usarlo per altro, come il selettore delle emoji o la dettatura di Apple. In quel caso Soffio non lo vede. Cambialo una volta:

Apri Impostazioni di Sistema > Tastiera.
Accanto a Premi il tasto 🌐 per, scegli Non fare nulla.

Soffio ti avvisa anche quando il tasto 🌐 è impostato su altro. Se preferisci non rinunciare al tasto 🌐, scegli un’altra scorciatoia di dettatura in Soffio, in Impostazioni > Tasti rapidi.

Chiave Groq (facoltativa)

Groq è un servizio cloud che trascrive la voce. Soffio funziona completamente senza, e Groq resta spento finché non salvi una chiave e lo attivi. Con la tua chiave, Soffio può usare Groq anche per la trascrizione e per i comandi. Non paghi niente in più a Soffio, e Soffio non aggiunge ricarichi.

Ottieni una chiave gratuita

Vai su console.groq.com/keys e accedi o crea un account.
Scegli Create API Key, dalle un nome qualsiasi e copia la chiave. Groq la mostra una sola volta.
In Soffio, apri Impostazioni > Cloud e AI, incolla la chiave e lascia che Soffio la verifichi. Viene salvata nel Portachiavi di macOS. Soffio ti chiede poi se usare Groq adesso, e ti dice che le registrazioni andranno a Groq. Se rispondi di no, non viene inviato niente.

Groq offre un piano gratuito con limiti di utilizzo. Limiti e condizioni li decide Groq, quindi controllali sul suo sito.

Cosa viene inviato

Niente finché Groq è spento o non ha una chiave.
Con la trascrizione cloud attiva: ogni registrazione e le parole del dizionario vanno a Groq, su api.groq.com. Puoi spegnere la trascrizione cloud e tenere la chiave.
Con la formattazione con AI attiva: il testo dettato, le parole del dizionario e il prompt di stile dell’app.
I comandi usano Groq quando attivi Groq, e hanno un proprio interruttore Groq in Impostazioni > Comandi. Con Groq inviano il testo selezionato e l’istruzione che hai detto. Con Ollama sul tuo Mac, niente esce dal Mac.
La chiave stessa va solo a Groq.

Per smettere di usare Groq, elimina la chiave in Impostazioni > Cloud e AI, oppure revocala nella console di Groq.

Riga di comando, link e agenti

Soffio include un comando soffio e un server MCP, così Claude Code, altri agenti e script possono usare dizionario, snippet e statistiche. Entrambi sono spenti di serie.

Per installare il comando, scegli Installa lo strumento da riga di comando nel menu Soffio. Crea il link ~/.local/bin/soffio. Se la shell non lo trova, aggiungi ~/.local/bin al tuo PATH. Esegui soffio help nel Terminale per vedere tutti i comandi.
Per permettere agli strumenti di leggere la Cronologia, attiva Impostazioni > Generali > Automazione > Consenti agli agenti di leggere la Cronologia.
Per permettere ad agenti e riga di comando di avviare e fermare la dettatura, attiva Consenti ad agenti e riga di comando di controllare la dettatura nello stesso punto. Per i link, attiva Consenti ai link di controllare la dettatura. Entrambi sono spenti di serie.
Il comando parla con l’app in esecuzione attraverso un file privato che solo il tuo utente può aprire. Niente passa dalla rete.

Link soffio://

Soffio risponde ai link soffio://. soffio://dictate/start e soffio://dictate/stop avviano e fermano la dettatura, e funzionano solo quando Consenti ai link di controllare la dettatura è attivo. soffio://licence/LA-TUA-CHIAVE apre Impostazioni > Licenza con la chiave già inserita. Non attiva mai da solo: il pulsante lo premi tu.

Risoluzione dei problemi

Non succede niente quando premo Fn

Controlla l’impostazione del tasto 🌐.
Controlla Accessibilità e Monitoraggio input in Impostazioni > Permessi. Vedi se un permesso non resta attivo.
Un’altra app potrebbe avere attivo l’input sicuro, per esempio un campo password selezionato. Fai clic fuori dal campo e riprova.

Il testo non è stato incollato

Alcuni campi, come quelli delle password, rifiutano il testo incollato. La dettatura non è persa. È in Cronologia, e Copia ultima dettatura nella barra dei menu la mette negli Appunti.

Nessun suono, o il microfono sbagliato

Scegli l’ingresso giusto in Impostazioni > Dettatura. Soffio propone anche Cambia microfono quando non sente nessun suono. Controlla che Soffio sia attivo in Microfono, in Impostazioni di Sistema.

Una VPN dà un errore 403 e Soffio passa al locale

Alcune VPN e reti condivise sono bloccate da Groq, che risponde con un errore 403. Soffio usa allora subito il motore locale, mostra un breve avviso e riprova Groq dopo 30 secondi, poi dopo 2 minuti, poi ogni 5 minuti. Non si perde niente e la dettatura continua a funzionare. Per usare di nuovo il cloud, spegni la VPN o escludi api.groq.com. Per non vedere più l’avviso, imposta la trascrizione cloud su No in Impostazioni > Cloud e AI.

Il modello vocale non si scarica

Controlla la connessione a internet, e spegni per un momento VPN, proxy o filtri dei contenuti.
Assicurati che il Mac abbia almeno 2 GB di spazio libero.
Esci da Soffio, elimina la cartella ~/Library/Application Support/Soffio/Models e riapri Soffio. Il download riparte dall’inizio.
Non funziona ancora? Scrivi al supporto e riporta cosa dice l’avviso.

macOS dice che l’app non può essere aperta

Soffio è firmato e autenticato, quindi non dovrebbe succedere. Scarica di nuovo l’immagine disco da questo sito e confronta il suo checksum con quello nella sezione download. Esegui shasum -a 256 e trascina il file nel Terminale. Se non funziona ancora, scrivi al supporto.

La dettatura sembra lenta

Sul tuo Mac, il testo arriva di solito circa 125 ms dopo che rilasci il tasto (mediana), e in 100-300 ms con il cloud. La prima dettatura dopo una lunga inattività può richiedere un po’ di più. Anche le dettature lunghe richiedono più tempo. Se è sempre lenta, controlla che la trascrizione cloud sia attiva solo se la vuoi e che nessuna VPN rallenti Groq.

Licenza

Una licenza vale per una persona su un massimo di 3 Mac. La prova dura 14 giorni dalla prima dettatura, senza carta. La chiave di licenza arriva nell’email di Polar dopo l’acquisto.

Inserisci la chiave

Apri Impostazioni > Licenza e scegli Inserisci licenza. Puoi anche fare clic sul link soffio://licence/… nell’email di acquisto, che apre lo stesso punto con la chiave già inserita.
Incolla la chiave e premi il pulsante per attivarla. Per questo passaggio Soffio ha bisogno di internet. Il Mac occupa poi uno dei tuoi 3 posti.

Ripristina su un nuovo Mac o dopo una reinstallazione

Installa Soffio, poi inserisci di nuovo la stessa chiave. Cronologia e impostazioni tornano se hai conservato la cartella dei dati. Hai perso la chiave? Apri l’email di Polar, oppure cercala nel portale clienti di Polar con l’indirizzo usato per l’acquisto, oppure scrivi al supporto.

Disattiva un Mac

In Impostazioni > Licenza, scegli Disattiva questo Mac. Così liberi il posto e puoi usare la chiave altrove. Fallo prima di vendere o inizializzare un Mac. Gestisci i Mac apre il portale clienti, dove puoi rimuovere un Mac che non raggiungi più. Se tutti i 3 posti sono occupati, Soffio te lo dice.

Uso offline

La prova funziona offline e non invia niente.
Dopo l’attivazione, Soffio verifica la licenza in background circa una volta a settimana, mai mentre detti.
Se una verifica fallisce perché sei offline, dietro una VPN o il servizio non risponde, non cambia niente. Per 30 giorni non viene mostrato niente. Dopo vedi una nota discreta che ti chiede di connetterti una volta, e Soffio continua a funzionare.
Una licenza si ferma solo quando Polar dice chiaramente che è stata rimborsata, revocata o è scaduta, in due verifiche ad almeno 7 giorni di distanza.

Quando la prova finisce

La dettatura e i comandi si fermano. Cronologia, Dizionario, Snippet e Impostazioni restano aperti e puoi esportarli. Non viene eliminato niente. Inserisci una licenza e la dettatura riparte.

Aggiornamenti

Soffio cerca gli aggiornamenti da solo e chiede prima di installarne uno. Puoi anche scegliere Controlla aggiornamenti dal menu Soffio. Gli aggiornamenti della versione 1 sono gratuiti.
Il controllo scarica un piccolo file e non invia dati personali. Puoi disattivarlo in Impostazioni.

Segnalazioni di arresto e diagnostica

Soffio non invia mai una segnalazione di arresto da solo, e non ha analisi.

Dopo un arresto, Soffio può proporti di inviare la segnalazione la volta successiva che lo apri. Puoi leggerla prima. Il nome della tua cartella Inizio è sostituito da ~. Invia per email apre un’email a support@getsoffio.app con il file allegato, e la invii tu dalla tua app di posta. Se scegli di non inviarla, niente lascia il tuo Mac.
Copia diagnostica mette negli Appunti un breve riepilogo: le versioni di Soffio e di macOS e il modello del tuo Mac. Incollalo in un’email al supporto, o dove vuoi. Non contiene testo dettato.
Una segnalazione di arresto è tecnica. Non dovrebbe contenere le tue dettature, ma leggila prima di inviarla.

Disinstallare

Prima esci da Soffio. Poi rimuovi ciò che vuoi rimuovere. Eliminare solo l’app lascia i tuoi dati al loro posto, così una reinstallazione li ritrova.

L’app

Trascina Soffio.app da Applicazioni al Cestino.
Rimuovilo da Impostazioni di Sistema > Generali > Elementi login se lo facevi partire all’accesso.

Cosa tiene Soffio sul tuo Mac

File e impostazioni che Soffio crea
Dove	Cosa contiene
`~/Library/Application Support/Soffio/`	Cronologia, dizionario, snippet e statistiche (`Soffio.store`), le registrazioni salvate (`Recordings`, conservate 14 giorni di serie; puoi cambiarlo in Impostazioni > Generali), log con soli numeri di tempo e nessun testo dettato (`Logs`), il modello vocale (`Models`, circa 613 MB), una copia dell’inizio della prova e il file socket per gli agenti.
`~/Library/Preferences/com.robertocinetto.soffio.plist`	Le tue impostazioni.
`~/Library/Caches/com.robertocinetto.soffio`	File temporanei.
Portachiavi, nell’app Accesso Portachiavi	La chiave Groq e la licenza, se le hai inserite. Cerca `com.robertocinetto.soffio`.
`~/.local/bin/soffio`	I link dello strumento da riga di comando, se era installato.
`~/Library/Logs/DiagnosticReports/`	Le segnalazioni di arresto che macOS ha scritto per Soffio (`Soffio-*.ips`), se si è mai arrestato. Eliminale se vuoi.
Privacy e sicurezza	Le voci dei permessi. Per cancellarle: `tccutil reset All com.robertocinetto.soffio`

Per rimuovere tutto in un colpo, copia questo nel Terminale dopo essere uscito da Soffio e aver spostato l’app nel Cestino. Elimina la tua Cronologia per sempre, quindi esporta prima ciò che ti serve.

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

Prima di disinstallare per sempre, scegli Disattiva questo Mac in Impostazioni > Licenza per liberare il posto. Altrimenti rimuovi il Mac nel portale clienti di Polar, oppure scrivi al supporto e lo liberiamo noi. Il comando qui sopra non rimuove gli elementi del Portachiavi per la licenza e la chiave Groq: eliminali in Accesso Portachiavi.

Tutto ciò che serve per iniziare.