Manual do EchoClip

Do download ao primeiro clipe. Leva uns 10 minutos.

1. Instalar

Baixe o arquivo do seu sistema na seção Downloads. Se o seu sistema aparece como “Em breve”, ainda não há versão para ele.

macOS

Abra o .dmg e arraste o EchoClip para a pasta Aplicativos.
O app tem assinatura ad hoc, sem notarização da Apple, então na primeira abertura o macOS bloqueia. Clique com o botão direito (ou Control + clique) no EchoClip em Aplicativos e escolha Abrir, depois confirme em Abrir.
Se o macOS ainda recusar, vá em Ajustes do Sistema → Privacidade e Segurança, role até a mensagem sobre o EchoClip e clique em Abrir Mesmo Assim.
Na primeira vez que o app usar o microfone, o macOS pede permissão: clique em Permitir. Se negou sem querer, ative em Ajustes do Sistema → Privacidade e Segurança → Microfone → EchoClip.

A primeira abertura pode levar alguns segundos, porque o macOS verifica a assinatura.

Windows e Linux

Ainda não há versão testada. Quando houver arquivo na seção Downloads, as instruções de instalação aparecerão junto dele.

2. Configurar o OBS

Use o OBS Studio 33 ou mais novo. Ao todo são três ajustes.

Servidor WebSocket

No OBS, abra Ferramentas → Configurações do servidor WebSocket.
Marque Ativar servidor WebSocket.
Marque Ativar autenticação e defina uma senha. Guarde-a: você vai colar no EchoClip.
Deixe a porta em 4455 (padrão).

Segurança: o WebSocket do OBS escuta em toda a rede local. Sem senha, qualquer aparelho da sua rede pode controlar o OBS. Use sempre senha. O EchoClip só conecta em 127.0.0.1/localhost.

Replay Buffer

Em Configurações → Saída → Buffer de Repetição, ative o Replay Buffer.
Defina o tempo máximo com pelo menos: segundos antes + segundos depois + 10 s. Para 60 s antes e 20 s depois, use 90 s ou mais. O EchoClip mostra o valor necessário e tem o botão “Ajustar buffer”.
Reinicie o OBS: ativar o Replay Buffer pela primeira vez só vale depois de reiniciar o OBS. Mudar o tempo vale depois de reiniciar o Replay Buffer.

O EchoClip não inicia transmissão nem gravação. Ele só salva o Replay Buffer.

Keyframe de 2 segundos

O corte sem recodificar só começa num keyframe, então o clipe pode começar até um intervalo de keyframe antes do pedido. O padrão do OBS é cerca de 8 s. Para ficar em até 2 s:

Modo Avançado: Saída → Gravação (e Transmissão) → Intervalo de keyframe = 2 s; ou
Modo Simples: Saída → Avançado → configurações do encoder, e use keyint=60 a 30 quadros por segundo no x264.

O que entra no clipe

Exatamente o que o Replay Buffer grava: a cena de programa (com overlays, alertas e câmera) e as faixas de áudio da gravação. Se o microfone ou o áudio do jogo não estiverem nas faixas de gravação do OBS, não estarão no clipe.

3. Primeiro uso

Ao abrir o app pela primeira vez, o assistente guia a configuração inicial:

Licença: cole a chave de ativação.
OBS: informe o servidor (127.0.0.1), a porta (4455) e a senha do WebSocket.
Microfone: escolha o dispositivo de entrada e fale para ver o nível se mexer.
Frase de ativação: digite a frase (2 a 6 palavras) e o idioma. O app avisa se alguma palavra não existe no vocabulário do reconhecimento; troque por outra.
Pasta de destino: escolha onde os clipes finalizados serão salvos.
Relatórios de erro: escolha se aceita enviar relatórios de erro (opcional).
Confira o resumo e conclua. Tudo pode ser mudado depois em Configurações.

4. Uso no dia a dia

Falar a frase

Diga a frase sozinha, com uma pequena pausa antes e depois. “Clipa isso aí” dispara; “nossa, clipa isso aí” ou “vou clipar isso aí depois” não. Frases de uma só palavra disparam por engano, por isso o mínimo é de duas.

Sensibilidade

Em Configurações → Voz, o controle de sensibilidade ajusta o quanto o reconhecimento exige de cada palavra. Mais sensível pega frases ditas baixo ou com sotaque, mas aumenta o risco de disparos por engano. Se não dispara, aumente um pouco; se dispara à toa, diminua.

Testar o reconhecimento

Em Configurações → Voz há o teste de reconhecimento. Com ele ligado, o app mostra o que ouviu, mas nenhum clipe é criado. O teste usa as configurações salvas, então salve antes de testar mudanças.

Comandos com duração

Opcional, desligado por padrão. Com “Comandos com duração” ligado, você fala a frase seguida de um tempo (por exemplo, a frase e “trinta segundos”) e essa duração vale só para aquele clipe. Há opções como quinze, trinta e quarenta e cinco segundos, e de um a três minutos.

Antes e depois

“Capturar período anterior ao comando” vai de 5 a 180 segundos (padrão 60). “Capturar período após o comando” vai de 0 a 180 segundos. O app só entrega o clipe depois do período “depois”.

Botão e atalho

Na tela inicial, o botão Clipe manual cria um clipe sem usar a voz. Há também um atalho global do teclado, configurável em Configurações. Se o sistema não deixar registrar o atalho, o app avisa e continua funcionando.

Pasta de destino e histórico

Os clipes vão para a pasta escolhida em Configurações → Destino. A aba Histórico lista os clipes, com a origem (voz, botão ou atalho), e permite renomear e excluir. Se o corte falhar, o app mantém o replay completo do OBS e informa onde ele está.

Intervalo entre clipes

O cooldown (padrão 5 s) ignora comandos repetidos logo em seguida. Se você pedir outro clipe enquanto o anterior ainda espera o “depois”, e o momento já está dentro dele, o pedido é ignorado.

5. Licença

Ativar: em Configurações → Licença, cole a chave no formato EC-XXXXX-XXXXX-XXXXX-XXXXX e ative. Precisa de internet nessa hora.
Uma chave, um computador por vez. Reinstalar o app no mesmo computador reativa sem problema.
Trocar de computador: no computador antigo, clique em Desativar neste PC (precisa de internet), e depois ative no novo com a mesma chave. Se o computador antigo não existe mais, peça a liberação da chave a quem vendeu.
Offline: o app renova a licença sozinho depois de 7 dias e continua funcionando sem internet por até 30 dias a partir da última renovação. Depois disso, conecte à internet para voltar a usar.

6. Privacidade

O reconhecimento de voz é local: áudio, frases e vídeos não saem do computador. O servidor de licenças recebe a chave, um identificador embaralhado do computador, o nome do computador (como rótulo) e a versão do app.

Relatórios de erro opcionais: se você aceitar na configuração inicial, o app envia descrições técnicas de falhas (tipo do erro, mensagem, versão do app e sistema operacional). Nunca envia áudio, frases, senhas, vídeo ou caminhos de pastas. Os relatórios ficam guardados por 90 dias e servem só para corrigir problemas.

7. Solução de problemas

“Conecte ao OBS para criar clipes” / “Ainda não conectado”: Confirme que o OBS está aberto, que o servidor WebSocket está ativado e que host, porta e senha no EchoClip são os mesmos do OBS.
“Replay Buffer desativado nas configurações de saída do OBS”: Ative o Buffer de Repetição em Configurações → Saída no OBS e reinicie o OBS.
“Replay Buffer parado”: Inicie o Replay Buffer no OBS, ou pelo botão correspondente no EchoClip.
“O OBS tinha menos vídeo guardado do que o pedido”: O buffer foi iniciado há pouco ou o tempo máximo é menor que antes + depois. O clipe sai com o que existia. Aumente o tempo do buffer (aba OBS).
O clipe começa vários segundos antes: É o intervalo de keyframe do OBS. Ajuste para 2 s (seção 2).
Falo a frase e nada acontece: Use o teste de reconhecimento. Verifique o microfone escolhido, a permissão de microfone do sistema e a pausa antes e depois da frase. Suba a sensibilidade em pequenos passos. Palavras raras podem não existir no vocabulário: o app avisa ao cadastrar a frase.
O clipe dispara quando eu só converso: Diminua a sensibilidade e use uma frase de 3 ou mais palavras.
Sem áudio no clipe: No OBS, confira se o microfone e o áudio do jogo estão nas faixas de áudio da gravação.
Licença “em uso”, “revogada” ou “expirada”: Em uso: a chave está ativa em outro computador; desative lá primeiro. Revogada: fale com quem vendeu a chave. Expirada: o app ficou mais de 30 dias sem renovar; conecte à internet.

8. Limitações

O reconhecimento usa um modelo pequeno: palavras fora do vocabulário (por exemplo, “Jarvis”) não podem fazer parte da frase.
A frase precisa ser dita sozinha, com pausa antes e depois.
O início do clipe pode vir até um intervalo de keyframe antes do pedido. O fim é preciso até cerca de 0,1 s. Precisão de quadro no início não é prometida.
Os testes foram feitos com voz sintetizada, no macOS em Mac com Apple Silicon e OBS 33. Teste com vozes reais, jogo em tela cheia, console, celular e sessões longas ainda está pendente.
Ativar o Replay Buffer pela primeira vez exige reiniciar o OBS.
O app para macOS não tem notarização da Apple.