Lispr ← Back to lispr.ai
Ajuda

Tira o máximo partido do Lispr.

O Lispr é pequeno de propósito — não há janela de definições, nem conta, nem surpresas. Esta página explica o que faz, como reparar as poucas coisas que de vez em quando correm mal, e o que acontece com a tua voz.

Configuração inicial

O Lispr guia-te por isto no primeiro arranque — é o mesmo fluxo, escrito caso precises de o repetir.

1. Microfone

O Lispr precisa de te ouvir. O macOS vai pedir-te da primeira vez; se perdeste o pedido ou revogaste a permissão, concede-a em Definições do Sistema → Privacidade e segurança → Microfone — liga o Lispr.

2. Acessibilidade

O Lispr insere o texto reconhecido onde tens o cursor — isso requer a permissão de Acessibilidade. Concede-a em Definições do Sistema → Privacidade e segurança → Acessibilidade — liga o Lispr.

3. Input Monitoring (apenas em macOS 10.15+)

Para que o Lispr possa ouvir quando manténs a tecla de acionamento premida — mesmo quando outra aplicação está em foco. Concede-a em Definições do Sistema → Privacidade e segurança → Input Monitoring. O Lispr pede-a corretamente via IOHIDRequestAccess desde a 0.33.

Nenhuma destas permissões cria conta nem envia nada para fora da tua máquina ao serem concedidas. Apenas desbloqueiam as partes do macOS que o Lispr precisa para funcionar mesmo.

Uso diário

Pressionar para falar

Mantém premida a tecla direita, fala, larga. O texto aparece no teu cursor em qualquer aplicação. É só isto — sem palavra de ativação, sem modo de escuta, sem definições.

Modo travado (mãos livres)

Faz duplo toque na tecla de acionamento e o Lispr continua a gravar até voltares a tocar. Útil quando precisas das duas mãos livres.

Cancelar a meio da gravação

Pressiona Esc durante a gravação para descartar o que disseste — nada é transcrito, nada é inserido.

Teclas de acionamento alternativas

Se a tecla direita estiver ocupada por outro atalho no teu Mac, o Lispr também suporta a tecla Fn como acionador push-to-talk.

Idiomas

O Lispr transcreve via Whisper, que é multilingue. O idioma é detetado automaticamente — podes até trocar a meio da frase e ele acompanha. Cerca de 99 idiomas reconhecidos, sem configuração.

União inteligente de frases

Se ditas uma frase e logo a seguir voltas a ditar, o Lispr insere um ponto e um espaço entre elas — sem frases coladas. Só une automaticamente após a sua própria inserção anterior, por isso não mexe no texto que escreveste tu próprio.

Área de transferência

O Lispr usa a área de transferência internamente para inserir texto — mas restaura imediatamente o que tinhas copiado. O teu ⌘V continua a devolver-te o link ou parágrafo que copiaste há uma hora.

Atualizações

O Lispr atualiza-se automaticamente via Sparkle — quando uma nova versão é assinada, o Lispr instalado oferece-a no próximo arranque. Vê o changelog para o que mudou em cada versão.

Resolução de problemas

A tecla de acionamento não faz nada

  • Verifica que Input Monitoring está concedido (passo 3 acima) — sem isso o Lispr não vê o pressionar da tecla a partir de uma aplicação em fundo.
  • Garante que nenhuma outra aplicação está a capturar a direita — Karabiner, BetterTouchTool, atalhos do Raycast, Magnet etc. Se for o caso, muda o Lispr para Fn pelo ícone da barra de menus.

"Não apanhámos isso"

O Lispr filtra gravações muito curtas e silenciosas (desde 0.39) — cerca de 9 em 10 destas eram silêncios breves, não palavras perdidas. Se isto aparece e tu de facto falaste: mantém a tecla um instante a mais antes de falar e confirma que o dispositivo de entrada correto está selecionado no ícone da barra de menus.

O texto acaba na aplicação errada

O Lispr insere no cursor com foco quando largas a tecla de acionamento. Se trocaste de aplicação a meio da gravação, o texto vai para a nova aplicação. Dica: deixa o cursor no destino antes de manter a tecla premida.

Falta o ícone da barra de menus

  • Especificamente em macOS 11–12, uma build antiga (≤ 0.24) podia perder o ícone — atualiza para a mais recente a partir da página do changelog; corrigido na 0.25.
  • Se estás num macOS recente e ainda assim não o vês: a tua barra de menus pode estar cheia e o ícone escondido por baixo do Control Center / Bartender. Tenta libertar a barra escondendo alguns ícones.

Tempo de transcrição esgotado

Se a tua rede oscila, o Lispr agora desiste ao fim de 10 segundos (desde 0.34) e mostra uma mensagem amigável. Tenta de novo — o pedido seguinte costuma passar porque o Lispr também tenta automaticamente em falhas transitórias (desde 0.31).

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

O DMG e o appcast são servidos por proxy.lispr.ai num caminho TCP-only (desde 0.39) — isto contorna problemas de HTTP/3 que algumas redes têm. Se a tua rede continuar a bloquear, podes sempre transferir o Lispr.dmg mais recente diretamente de lispr.ai e substituir a aplicação à mão.

Limite de 10 minutos de gravação

O Lispr para uma única gravação ao fim de 10 minutos com um aviso localizado (desde 0.37) — é um teto suave para evitar que gravações maratona acidentais passem. Larga e começa 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 teu Mac vai por uma ligação encriptada até um proxy de fronteira que operamos, que a encaminha para o Groq para transcrição. O Groq devolve o texto, o proxy devolve-o ao teu Mac, e o áudio é descartado de imediato. Nada é guardado num servidor. Nada treina um modelo.

Há conta?

Não. Sem registo, sem palavra-passe, sem perfil. Não há nada onde fazer login porque não há nada onde fazer login.

E os logs?

Desde a 0.40, o Lispr pode enviar cabeçalhos de diagnóstico X-Lispr-* quando algo corre mal — são cabeçalhos (tempos, códigos de erro), não áudio ou transcrições, e não os guardamos no servidor.

Funciona offline?

Não — a transcrição corre na nuvem, e é por isso que é simultaneamente rápida (mediana ~300 ms ponta-a-ponta desde 0.41) e precisa. Se precisares de ditado totalmente local, o Ditado integrado do macOS é uma alternativa decente; é o compromisso que fizemos por velocidade e cobertura de idiomas.

Ainda preso?

Se nada aqui respondeu à tua questão — escreve-nos com a versão (barra de menus → Acerca do Lispr) e o que estavas a fazer quando rebentou. A gente investiga.

[email protected]