Ajuda | Soffio

Primeiro uso

Abra a imagem de disco e arraste o Soffio para a pasta Aplicativos. Abra-o de lá.
O Soffio baixa o modelo de voz uma vez (cerca de 613 MB). Deixe o app aberto até terminar. Depois disso, o ditado funciona offline.
Conceda as permissões abaixo quando o Soffio pedir. Você pode conferi-las quando quiser no Soffio, em Ajustes > Permissões.
Clique em qualquer campo de texto, pressione Fn, fale e pressione Fn de novo. Para cancelar, pressione Esc.

Seu teste de 14 dias começa no seu primeiro ditado.

Permissões

O macOS guarda essas opções em Ajustes do Sistema > Privacidade e Segurança. O Soffio precisa das três primeiras. A quarta é opcional.

Permissões que o Soffio pede
Permissão	Por que o Soffio precisa dela
Microfone	Para ouvir você enquanto dita. O áudio só é gravado enquanto a barra aparece. Sem ela, não há nada para transcrever.
Acessibilidade	Para perceber sua tecla de ditado e colar o texto no app que você está usando, como se você pressionasse `⌘V`.
Monitoração de Entrada	Para notar a tecla de ditado enquanto outro app está na frente. O Soffio só procura as próprias teclas e não grava nem envia o que você digita.
Automação	Opcional. Só para o Soffio poder pausar o Spotify ou o Música enquanto você dita. Se você recusar, todo o resto funciona.

Se uma permissão não ficar ativada

Abra a lista correspondente nos Ajustes do Sistema, desative o Soffio e ative de novo. Se o item parecer travado, selecione-o, clique no botão de menos e adicione o Soffio de novo com o botão de mais.
Encerre o Soffio pelo ícone na barra de menus e abra de novo. O macOS só aplica Acessibilidade e Monitoração de Entrada depois que o app reinicia.
Ainda travado? Redefina os itens e conceda de novo. No Terminal:
```
tccutil reset All com.robertocinetto.soffio
```

A tecla Fn (🌐)

Na maioria dos Macs, a tecla Fn também é a tecla 🌐, e o macOS pode usá-la para outra coisa, como o seletor de emoji ou o ditado da própria Apple. Nesse caso, o Soffio não consegue vê-la. Mude isso uma vez:

Abra Ajustes do Sistema > Teclado.
Ao lado de Pressionar a tecla 🌐 para, escolha Não fazer nada.

O Soffio também avisa quando a tecla 🌐 está configurada para outra coisa. Se preferir não abrir mão da tecla 🌐, escolha outro atalho de ditado no Soffio, em Ajustes > Teclas de atalho.

Chave do Groq (opcional)

O Groq é um serviço de nuvem que transcreve fala. O Soffio funciona por completo sem ele, e o Groq fica desativado até você salvar uma chave e ativá-lo. Com sua própria chave, o Soffio também pode usar o Groq para a transcrição e para os comandos. Você não paga nada a mais ao Soffio, e o Soffio não cobra acréscimo.

Consiga uma chave grátis

Acesse console.groq.com/keys e entre ou crie uma conta.
Escolha Create API Key, dê qualquer nome e copie a chave. O Groq só a mostra uma vez.
No Soffio, abra Ajustes > Nuvem e IA, cole a chave e deixe o Soffio testá-la. Ela fica salva nas Chaves do macOS. Depois o Soffio pergunta se você quer usar o Groq agora e avisa que as gravações irão para o Groq. Se você disser não, nada é enviado.

O Groq oferece um plano grátis com limites de uso. Quem define os limites e os termos é o Groq, então confira no site deles.

O que é enviado

Nada enquanto o Groq estiver desativado ou sem chave.
Com a transcrição na nuvem ativada: cada gravação e as palavras do seu dicionário vão para o Groq, em api.groq.com. Você pode desativar a transcrição na nuvem e manter a chave.
Com a formatação com IA ativada: o texto ditado, as palavras do seu dicionário e o prompt de estilo do app.
Os comandos usam o Groq assim que você ativa o Groq, e têm uma opção própria do Groq em Ajustes > Comandos. Com o Groq, eles enviam o texto selecionado e a instrução que você falou. Com o Ollama no seu Mac, nada sai dele.
A chave em si só vai para o Groq.

Para parar de usar o Groq, apague a chave em Ajustes > Nuvem e IA, ou revogue-a no console do Groq.

Linha de comando, links e agentes

O Soffio inclui um comando soffio e um servidor MCP para que o Claude Code, outros agentes e scripts possam usar seu dicionário, seus snippets e suas estatísticas. Os dois vêm desativados.

Para instalar o comando, escolha Instalar a ferramenta de linha de comando no menu do Soffio. Ele cria o link ~/.local/bin/soffio. Se o seu shell não o encontrar, adicione ~/.local/bin ao seu PATH. Rode soffio help no Terminal para ver todos os comandos.
Para deixar ferramentas lerem o Histórico, ative Ajustes > Geral > Automação > Permitir que agentes leiam o Histórico.
Para deixar agentes e a linha de comando iniciarem e encerrarem o ditado, ative Permitir que agentes e a linha de comando controlem o ditado no mesmo lugar. Para os links, ative Permitir que links controlem o ditado. Os dois vêm desativados.
O comando fala com o app aberto por um arquivo privado que só o seu usuário pode abrir. Nada passa pela rede.

Links soffio://

O Soffio responde a links soffio://. soffio://dictate/start e soffio://dictate/stop iniciam e encerram o ditado, e só funcionam quando Permitir que links controlem o ditado está ativado. soffio://licence/SUA-CHAVE abre Ajustes > Licença com a chave já preenchida. Nada é ativado sozinho: quem pressiona o botão é você.

Solução de problemas

Nada acontece quando pressiono Fn

Confira o ajuste da tecla 🌐.
Confira Acessibilidade e Monitoração de Entrada em Ajustes > Permissões. Veja se uma permissão não ficar ativada.
Outro app pode estar com a entrada segura ativada, por exemplo um campo de senha selecionado. Clique fora dele e tente de novo.

O texto não foi colado

Alguns campos, como os de senha, recusam texto colado. O ditado não se perde. Ele está no Histórico, e Copiar último ditado na barra de menus o coloca na Área de Transferência.

Sem som, ou o microfone errado

Escolha a entrada certa em Ajustes > Ditado. O Soffio também oferece Trocar de microfone quando não ouve nenhum som. Confira se o Soffio está ativado em Microfone, nos Ajustes do Sistema.

Uma VPN dá erro 403 e o Soffio volta para o local

Algumas VPNs e redes compartilhadas são bloqueadas pelo Groq, que responde com erro 403. O Soffio então usa o mecanismo local na hora, mostra um aviso curto e tenta o Groq de novo depois de 30 segundos, depois de 2 minutos e então a cada 5 minutos. Nada se perde e o ditado continua funcionando. Para usar a nuvem de novo, desligue a VPN ou exclua api.groq.com dela. Para parar o aviso, desative a transcrição na nuvem em Ajustes > Nuvem e IA.

O modelo de voz não baixa

Confira sua conexão com a internet e desligue por um momento qualquer VPN, proxy ou filtro de conteúdo.
Verifique se o Mac tem pelo menos 2 GB livres.
Encerre o Soffio, apague a pasta ~/Library/Application Support/Soffio/Models e abra o Soffio de novo. O download recomeça do início.
Ainda falha? Escreva para o suporte e conte o que diz o aviso.

O macOS diz que o app não pode ser aberto

O Soffio é assinado e autenticado, então isso não deveria acontecer. Baixe a imagem de disco de novo neste site e compare o checksum com o da seção de download. Rode shasum -a 256 e arraste o arquivo para o Terminal. Se ainda falhar, escreva para o suporte.

O ditado parece lento

No seu Mac, o texto costuma chegar cerca de 125 ms depois que você solta a tecla (mediana), e em 100 a 300 ms com a nuvem. O primeiro ditado depois de muito tempo parado pode levar um pouco mais. Ditados longos também. Se estiver sempre lento, confira se a transcrição na nuvem só está ativada se você quiser e se nenhuma VPN está deixando o Groq lento.

Licença

Uma licença é para uma pessoa em até 3 Macs. O teste dura 14 dias a partir do seu primeiro ditado, sem cartão. Sua chave de licença chega no e-mail da Polar depois da compra.

Insira sua chave

Abra Ajustes > Licença e escolha Inserir licença. Você também pode clicar no link soffio://licence/… do e-mail de compra, que abre o mesmo lugar com a chave já preenchida.
Cole a chave e pressione o botão para ativar. O Soffio precisa de internet nesta etapa. O Mac passa a ocupar uma das suas 3 vagas.

Restaurar num Mac novo ou depois de reinstalar

Instale o Soffio e insira a mesma chave de novo. Seu Histórico e seus ajustes voltam se você manteve a pasta de dados. Perdeu a chave? Abra o e-mail da Polar, procure no portal do cliente da Polar com o e-mail da compra, ou escreva para o suporte.

Desativar um Mac

Em Ajustes > Licença, escolha Desativar este Mac. Isso libera a vaga para você usar a chave em outro lugar. Faça isso antes de vender ou apagar um Mac. Gerenciar Macs abre o portal do cliente, onde você pode remover um Mac que não alcança mais. Se as 3 vagas estiverem ocupadas, o Soffio avisa.

Uso offline

O teste funciona offline e não envia nada.
Depois da ativação, o Soffio verifica sua licença em segundo plano cerca de uma vez por semana, nunca enquanto você dita.
Se uma verificação falhar porque você está offline, atrás de uma VPN ou o serviço está fora do ar, nada muda. Por 30 dias, nada aparece. Depois disso você vê uma nota discreta pedindo para se conectar uma vez, e o Soffio continua funcionando.
Uma licença só para quando a Polar diz claramente que ela foi reembolsada, revogada ou expirou, em duas verificações com pelo menos 7 dias de intervalo.

Quando o teste termina

O ditado e os comandos param. Histórico, Dicionário, Snippets e Ajustes continuam abertos e você pode exportá-los. Nada é apagado. Insira uma licença e o ditado volta.

Atualizações

O Soffio busca atualizações sozinho e pergunta antes de instalar uma. Você também pode escolher Buscar atualizações no menu do Soffio. As atualizações da versão 1 são grátis.
A verificação baixa um arquivo pequeno e não envia dados pessoais. Você pode desativá-la nos Ajustes.

Relatórios de falha e diagnóstico

O Soffio nunca envia um relatório de falha por conta própria, e não tem análises.

Depois de uma falha, o Soffio pode oferecer enviar o relatório na próxima vez que você o abrir. Você pode ler antes. O nome da sua pasta de usuário é trocado por ~. Enviar por e-mail abre um e-mail para support@getsoffio.app com o arquivo anexado, e você mesmo envia pelo seu app de e-mail. Se escolher não enviar, nada sai do seu Mac.
Copiar diagnóstico coloca um resumo curto na Área de Transferência: as versões do Soffio e do macOS e o modelo do seu Mac. Cole num e-mail para o suporte, ou onde quiser. Não contém texto ditado.
Um relatório de falha é técnico. Ele não deveria conter seus ditados, mas leia antes de enviar.

Desinstalar

Primeiro encerre o Soffio. Depois remova o que quiser remover. Apagar só o app deixa seus dados onde estão, então uma reinstalação depois os encontra de novo.

O app

Arraste Soffio.app de Aplicativos para o Lixo.
Remova-o de Ajustes do Sistema > Geral > Itens de Início de Sessão se ele abria ao iniciar a sessão.

O que o Soffio guarda no seu Mac

Arquivos e ajustes que o Soffio cria
Onde	O que contém
`~/Library/Application Support/Soffio/`	Seu Histórico, dicionário, snippets e estatísticas (`Soffio.store`), as gravações salvas (`Recordings`, 14 dias por padrão; mude em Ajustes > Geral), registros só com números de tempo e sem texto ditado (`Logs`), o modelo de voz (`Models`, cerca de 613 MB), uma cópia do início do seu teste e o arquivo de socket para agentes.
`~/Library/Preferences/com.robertocinetto.soffio.plist`	Seus ajustes.
`~/Library/Caches/com.robertocinetto.soffio`	Arquivos temporários.
Chaves, no app Acesso às Chaves	Sua chave do Groq e sua licença, se você as inseriu. Procure por `com.robertocinetto.soffio`.
`~/.local/bin/soffio`	Links da ferramenta de linha de comando, se ela foi instalada.
`~/Library/Logs/DiagnosticReports/`	Relatórios de falha que o macOS gravou para o Soffio (`Soffio-*.ips`), se ele já falhou. Apague se quiser.
Privacidade e Segurança	Os itens de permissão. Para limpá-los: `tccutil reset All com.robertocinetto.soffio`

Para remover tudo de uma vez, copie isto no Terminal depois de encerrar o Soffio e mover o app para o Lixo. Isso apaga seu Histórico para sempre, então exporte antes o que precisar.

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 desinstalar de vez, escolha Desativar este Mac em Ajustes > Licença para liberar a vaga. Se não, remova o Mac no portal do cliente da Polar, ou escreva para o suporte e nós liberamos para você. O comando acima não remove os itens das Chaves da sua licença e da sua chave do Groq: apague-os no Acesso às Chaves.

Tudo o que você precisa para começar.