Instalação no macOS

Instale

1. Baixe o RealtimeClipboard_<version>_universal.dmg na página de releases.
2. Abra o arquivo e arraste o RealtimeClipboard para Aplicativos.
3. Abra o aplicativo. Ele exige macOS 11 ou mais recente.

Há um download só, não dois. O fluxo de release compila com --target universal-apple-darwin, então o mesmo arquivo roda nativamente nas duas arquiteturas. Se você está procurando uma build separada para Apple Silicon, ela já está na sua mão.

Ou por um gerenciador de pacotes

brew install --cask akshaynikhare/tap/realtimeclipboard

O cask fica em akshaynikhare/homebrew-tap e é gerado a cada release por tools/release/manifest.mjs, então a versão e a soma de verificação saem de um artefato que foi de fato compilado. Não precisa dar brew tap antes — nomear o tap no comando de instalação já basta.

É também o jeito mais fácil de contornar o problema do Gatekeeper: o cask remove o atributo de quarentena depois de instalar, e o aplicativo abre sem a ida a Privacidade e Segurança. Isso é o Homebrew fazendo por você o que você faria na mão, não uma assinatura — a build continua sem assinar.

O cliente de linha de comando é outra fórmula, realtimeclipboard-cli, e não é a mesma coisa que o aplicativo para desktop — veja o guia da linha de comando.

Confira se deu certo

• Aparece um item na barra de menus. Clique nele e o menu abre, como um item de barra de menus deve fazer — Open RealtimeClipboard é a primeira entrada e Quit é a última, de propósito: um aplicativo que observa a sua área de transferência precisa ter um jeito visível de ser desligado. Fechar a janela no botão vermelho não encerra nada; o aplicativo fica na barra de menus para continuar observando.
• A barra de status mostra T0 · watching the system clipboard, no canto inferior direito da janela. É o observador nativo se confirmando. O Safari na mesma máquina mostra T1 · paste only, e essa diferença é o motivo de você ter instalado isto.

Sua primeira sincronização

1. Anote a chave curta no topo do aplicativo, ou digite a sua.
2. Abra o aplicativo em um segundo dispositivo e informe a mesma chave.
3. Copie algo no Mac, sem voltar para o RealtimeClipboard. O conteúdo aparece no outro dispositivo.

Não aconteceu nada? Confira se o seletor no topo da janela está em Clipboard. Em App, nada sai do Mac até você colar ali dentro. Vale saber que esse seletor existe: o macOS libera a área de transferência para qualquer aplicativo em execução sem aviso nenhum, então nada no sistema operacional contaria a você que este aplicativo passou a ler tudo o que você copia — é por isso que ele mesmo avisa, na primeira abertura, e coloca o mesmo seletor na barra de menus como Share what I copy.

Quando não funciona

“Não é possível abrir o RealtimeClipboard porque não é possível verificar o desenvolvedor”

É esperado, e não é sinal de download quebrado. A build não é assinada nem notarizada, porque as duas coisas exigem uma conta paga de Apple Developer que este projeto ainda não tem. O Gatekeeper recusa qualquer coisa sem notarização na primeira vez.

1. Tente abrir o aplicativo uma vez e deixe que ele seja recusado.
2. Ajustes do Sistema → Privacidade e Segurança, role para baixo: agora existe uma linha citando o RealtimeClipboard, com um botão Abrir Mesmo Assim.

No macOS 14 e anteriores, clicar no aplicativo com o botão direito e escolher Abrir faz o mesmo em um passo só. Esse atalho foi removido no macOS 15, e por isso o caminho mais longo vem primeiro.

Qualquer um dos dois registra uma exceção só para este aplicativo — algo bem mais estreito do que baixar a guarda do Gatekeeper de forma geral, o que você não deve fazer. Faça isso apenas com um arquivo obtido na página oficial de releases e, se quiser certeza, confira o SHA256 publicado no release contra o arquivo.

Não apareceu nenhum pedido de permissão

Não existe nenhum para aparecer. Diferente da câmera, do microfone ou da tela, a área de transferência do macOS pode ser lida por qualquer aplicativo em execução, sem pedir nada a ninguém. O aplicativo não tem como mostrar um alerta do sistema que não existe, então ele avisar por conta própria na primeira abertura é o substituto disso.

O conteúdo chega ao Mac, mas não sai dele

Isso é o ajuste App/Clipboard, não um defeito: receber sempre funciona, enviar é o que você escolhe.

Parado em “Connecting…”

O aplicativo tenta um WebSocket primeiro e cai para server-sent events mais POST onde o upgrade é bloqueado. Se nenhum dos dois conecta, o host do retransmissor está bloqueado por inteiro — aponte o aplicativo para o seu próprio em Settings → Relay. Rodar um é um container.

Desinstalar

Encerre pela barra de menus e arraste o aplicativo de Aplicativos para o Lixo, ou use brew uninstall --cask realtimeclipboard.

Nenhum conteúdo da área de transferência é gravado em disco, então não sobra nada para procurar e apagar depois. Seus ajustes e o histórico ficam no armazenamento do próprio navegador do aplicativo e vão embora com ele.

Pronto para instalar: a página de download. Todas as outras plataformas: o guia de instalação. Algo errado ou desatualizado aqui? Abra uma issue.