Lispr ← Back to lispr.ai
Ajuda

Tire o máximo do Lispr.

O Lispr é pequeno de propósito — não tem janela de configurações, não tem conta, não tem surpresa. Esta página explica o que ele faz, como consertar as poucas coisas que de vez em quando saem do trilho e o que acontece com a sua voz.

Configuração inicial

O Lispr te guia por isso no primeiro lançamento — esse é o mesmo fluxo, escrito caso você precise refazer.

1. Microfone

O Lispr precisa te ouvir. O macOS vai pedir da primeira vez; se você perdeu o aviso ou revogou a permissão, conceda em Ajustes do Sistema → Privacidade e Segurança → Microfone — ative o Lispr.

2. Acessibilidade

O Lispr insere o texto reconhecido onde está o seu cursor — isso requer a permissão de Acessibilidade. Conceda em Ajustes do Sistema → Privacidade e Segurança → Acessibilidade — ative o Lispr.

3. Input Monitoring (só no macOS 10.15+)

Para que o Lispr possa ouvir quando você segura a tecla de acionamento — mesmo com outro app em foco. Conceda em Ajustes do Sistema → Privacidade e Segurança → Input Monitoring. O Lispr solicita isso corretamente via IOHIDRequestAccess desde a 0.33.

Nenhuma dessas permissões cria conta nem manda nada para fora do seu Mac quando concedida. Elas só destravam as partes do macOS que o Lispr precisa para realmente funcionar.

Uso diário

Aperte para falar

Segure a tecla direita, fale, solte. O texto aparece no seu cursor em qualquer app. É só isso — sem palavra de ativação, sem modo de escuta, sem configurações.

Modo travado (mãos livres)

Toque duas vezes na tecla de acionamento e o Lispr continua gravando até você tocar de novo. Útil quando você precisa das duas mãos livres.

Cancelar no meio da gravação

Aperte Esc enquanto grava para descartar o que você disse — nada é transcrito, nada é inserido.

Teclas de acionamento alternativas

Se a direita está pega por outro atalho no seu Mac, o Lispr também aceita a tecla Fn como acionador push-to-talk.

Idiomas

O Lispr transcreve via Whisper, que é multilíngue. O idioma é detectado automaticamente — você pode até trocar no meio da frase e ele acompanha. Cerca de 99 idiomas são reconhecidos, sem configuração.

União inteligente de frases

Se você dita uma frase e dita outra logo em seguida, o Lispr insere um ponto e um espaço entre elas — sem frases coladas. Ele só une automaticamente após sua própria inserção anterior, então não mexe no texto que você digitou.

Área de transferência

O Lispr usa a área de transferência internamente para inserir texto — mas restaura logo depois o que você tinha copiado. Seu ⌘V ainda devolve o link ou parágrafo que você copiou uma hora atrás.

Atualizações

O Lispr atualiza sozinho via Sparkle — quando uma nova versão é assinada, o Lispr instalado oferece da próxima vez que o app abrir. Veja o changelog para o que mudou em cada versão.

Solução de problemas

A tecla de acionamento não faz nada

  • Confira se Input Monitoring foi concedido (passo 3 acima) — sem isso o Lispr não enxerga o pressionar da tecla a partir de um app em segundo plano.
  • Garanta que nenhum outro app está capturando a direita — Karabiner, BetterTouchTool, atalhos do Raycast, Magnet etc. Se for o caso, troque o Lispr para Fn pelo ícone da barra de menus.

"Não captamos isso"

O Lispr filtra gravações muito curtas e silenciosas (desde 0.39) — cerca de 9 em cada 10 eram silêncios curtos, não palavras perdidas. Se isso aparece e você realmente falou: segure a tecla um instante a mais antes de falar e verifique se o dispositivo de entrada certo está selecionado no ícone da barra de menus.

O texto vai parar no app errado

O Lispr insere no cursor que está em foco quando você solta a tecla de acionamento. Se você trocou de app no meio da gravação, o texto vai para o novo app. Dica: deixe o cursor no destino antes de segurar a tecla.

O ícone da barra de menus sumiu

  • Especificamente no macOS 11–12, uma build antiga (≤ 0.24) podia perder o ícone — atualize para a mais recente pela página de changelog; corrigido na 0.25.
  • Se você está num macOS recente e mesmo assim não vê: sua barra de menus pode estar cheia e o ícone escondido sob Control Center / Bartender. Tente liberar espaço escondendo alguns ícones.

Tempo esgotado na transcrição

Se sua rede oscila, o Lispr agora desiste depois de 10 segundos (desde 0.34) e mostra uma mensagem amigável. Tente de novo — a próxima requisição geralmente passa porque o Lispr também tenta de novo automaticamente em falhas temporárias (desde 0.31).

O Sparkle não consegue baixar a atualização

O DMG e o appcast são servidos por proxy.lispr.ai por um caminho TCP-only (desde 0.39) — isso contorna problemas de HTTP/3 que algumas redes têm. Se sua rede ainda bloquear, você sempre pode baixar o Lispr.dmg mais recente direto de lispr.ai e substituir o app manualmente.

O teto de 10 minutos de gravação

O Lispr para uma única gravação após 10 minutos com um aviso localizado (desde 0.37) — é um teto leve para evitar que gravações maratona acidentais passem. Solte e comece uma nova gravação para ditados mais longos.

Privacidade em resumo

A história completa está na Política de Privacidade; aqui a versão curta do que a maioria pergunta.

Para onde vai a minha voz?

Do seu Mac segue por uma conexão criptografada para um proxy de borda que a gente opera, que repassa para o Groq fazer a transcrição. O Groq devolve o texto, o proxy devolve para o seu Mac, e o áudio é descartado imediatamente. Nada é armazenado em servidor. Nada treina modelo.

Tem conta?

Não. Sem cadastro, sem senha, sem perfil. Não tem onde fazer login porque não tem onde fazer login.

E os logs?

Desde a 0.40, o Lispr pode enviar headers de diagnóstico X-Lispr-* quando algo dá errado — são headers (tempos, códigos de erro), não áudio ou transcrições, e a gente não guarda no servidor.

Funciona offline?

Não — a transcrição roda na nuvem, e por isso é ao mesmo tempo rápida (mediana ~300 ms de ponta a ponta desde 0.41) e precisa. Se você precisa de ditado totalmente local, o Ditado embutido do macOS é uma alternativa razoável; esse é o trade-off que a gente fez por velocidade e cobertura de idiomas.

Ainda travado?

Se nada aqui respondeu sua pergunta — escreve pra gente com a versão (barra de menus → Sobre o Lispr) e o que você estava fazendo quando travou. A gente investiga.

[email protected]