Instalando o RealtimeClipboard

O RealtimeClipboard roda no navegador de todos os dispositivos que você tem, e para isso não é preciso instalar nada. O que a instalação traz é uma coisa bem específica, e só em algumas plataformas: o aplicativo perceber o que você copiou enquanto trabalhava em outra janela.

Comece por aqui: você precisa instalar alguma coisa?

Provavelmente não. Abra o aplicativo em dois dispositivos, digite a mesma chave curta nos dois e eles passam a compartilhar uma área de transferência. Tudo o que vem abaixo é sobre um único recurso — a captura em segundo plano — e sobre se a sua plataforma dá conta dele.

PlataformaInstalaçãoCaptura em segundo plano
Windows 10 / 11Aplicativo desktopSim
macOS 11+Aplicativo desktopSim
Linux, X11Aplicativo desktopSim
Linux, WaylandAplicativo desktopKDE e wlroots sim; GNOME não
Android / ChromeOSAdicionar à tela inicialNão — bloqueada pelo Android
iPhone / iPadAdicionar à tela inicialNão — bloqueada pelo iOS
Servidores, SSHnpx realtimeclipboardNão se aplica — funciona por pipe
Qualquer outra coisaNada — use o navegadorNão

Cada plataforma tem abaixo um resumo e também um guia completo só dela — como é uma instalação funcionando, como fazer o primeiro trecho atravessar e as coisas específicas que impedem isso.

  • Instalação no Windows

    O .msi, o que o ícone na área de notificação e a barra de status devem dizer, e as três coisas que impedem tudo: o SmartScreen, uma máquina de trabalho travada e a sincronização de área de transferência do próprio Windows, que é outro recurso.

  • Instalação no macOS

    Um único download universal para Intel e Apple Silicon, o que o Gatekeeper vai dizer na primeira vez, e por que não existe permissão de área de transferência para conceder — que é exatamente o motivo de o aplicativo avisar por conta própria.

  • Instalação no Linux

    .deb, .rpm e AppImage, o piso do webkit2gtk 4.1 e a matriz do Wayland numa tabela só: X11 sim, KDE e wlroots sim, GNOME não e não há nada que resolva.

  • Android e ChromeOS

    Dois toques no Chrome, nenhuma listagem em loja e a regra do Android 10 que torna um aplicativo nativo inútil. Como é enviar de verdade quando a captura em segundo plano está fora de cogitação.

  • iPhone e iPad

    O menu Compartilhar do Safari é o mecanismo inteiro — o Chrome no iOS não dá conta, e nenhum aviso de instalação vai aparecer. Mais o que é aquele banner de colagem e por que nenhum aplicativo consegue desligá-lo.

  • A linha de comando

    Jogue por pipe no send, redirecione a saída do watch e veja os quatro comandos por inteiro. A mesma criptografia que o navegador usa, em qualquer máquina com Node 22.

  • Rodar o seu próprio retransmissor

    Um contêiner e nenhum banco de dados. Como verificar se está de pé, como colocar TLS na frente — e a armadilha de fixar uma réplica só, que aparece como trechos que simplesmente não chegam.

O que “captura em segundo plano” quer dizer de verdade

Num navegador, o RealtimeClipboard só consegue ler a sua área de transferência enquanto a janela dele está em foco. Isso não é uma limitação deste aplicativo — é uma regra que todo navegador impõe a todo site, porque uma página capaz de ler a área de transferência em silêncio colheria cada senha que você copia. Então a versão de navegador funciona assim: você copia alguma coisa, muda para o RealtimeClipboard e ele pega o conteúdo no momento em que ganha o foco.

Um aplicativo nativo de desktop não está preso a essa regra. O aplicativo para Windows, macOS e Linux observa a área de transferência do sistema continuamente, então copiar em qualquer programa já envia na hora, sem precisar trocar de janela.

O que significa que o aplicativo desktop lê cada cópia que você faz enquanto está rodando — inclusive senhas que você copiou por motivos totalmente alheios. O conteúdo é criptografado antes de sair da sua máquina e nunca é gravado em disco, mas isso é uma coisa real com que concordar. O aplicativo diz isso num guia na primeira abertura, com a chave no próprio diálogo: Aplicativo quer dizer que nada sai da máquina até você colar lá dentro, e ela também está no menu da área de notificação como Compartilhar o que eu copio, para você pausar o compartilhamento antes de copiar uma senha sem precisar abrir a janela.

Windows

Baixe o .msi na página de download. A captura em segundo plano funciona sem ressalvas e sem pedir permissão — o Windows é a plataforma em que o aplicativo desktop mais vale a pena.

O aplicativo não precisa de direitos de administrador e não instala driver nem serviço. Ele faz conexões de saída só na 443, para um único nome de host, que é o formato que os departamentos de TI liberam. Se o SmartScreen avisar, confira se o arquivo veio da página oficial de releases antes de seguir adiante.

Guia completo: instalação no Windows

macOS

Um .dmg cobre Intel e Apple Silicon — a build é universal, então não há um segundo download para procurar.

O macOS não exige permissão nenhuma para ler a área de transferência, então não há aviso para conceder. Isso corta dos dois lados: nada no sistema operacional avisaria você de que um aplicativo começou a ler cada cópia que você faz, e é por isso que este avisa sozinho, num guia na primeira abertura, com a chave Aplicativo no diálogo.

Guia completo: instalação no macOS

Linux

Um .deb, um .rpm ou um AppImage da página de releases. Não existe pacote no Flathub, no Snap nem no AUR, e não há aqui nenhum comando fingindo que existe. O aplicativo precisa do webkit2gtk 4.1, o que dá mais ou menos Ubuntu 22.04 ou Fedora 36 para cima; em qualquer coisa mais antiga use o navegador ou o cliente de linha de comando.

A ressalva do Wayland, dita sem rodeios. No X11 o aplicativo é avisado quando a área de transferência muda e a captura em segundo plano funciona. No Wayland depende do seu compositor: o KDE e os baseados em wlroots expõem um protocolo para isso, e o GNOME não — não há como aplicativo nenhum monitorar a área de transferência no GNOME Wayland. O aplicativo detecta isso e diz na barra de status, em vez de ficar em silêncio sem fazer nada, e volta a capturar no foco, exatamente como o navegador.

Guia completo: instalação no Linux

Android e ChromeOS

Não existe aplicativo Android, e não vai existir. Desde o Android 10, só o aplicativo que você está usando no momento, o teclado ativo ou um serviço de acessibilidade podem ler a área de transferência. Um aplicativo RealtimeClipboard seria, portanto, um botão no menu de compartilhamento e um ícone — todo o resto que ele poderia fazer, o aplicativo web instalado já faz.

  1. Abra o aplicativo no Chrome.
  2. Toque no menu e depois em Adicionar à tela inicial.

Ele passa a ter ícone e janela próprios, e funciona offline. Para enviar algo, cole no aplicativo ou use o menu de compartilhamento do Android.

Guia completo: Android e ChromeOS

iPhone e iPad

Mesma resposta, pelo mesmo motivo: o iOS nunca permitiu leitura da área de transferência em segundo plano e, desde o iOS 16, mostra um banner toda vez que qualquer aplicativo lê a área de transferência.

  1. Abra o aplicativo no Safari. O Chrome e o Firefox no iOS não conseguem instalar um aplicativo web.
  2. Toque em Compartilhar e depois em Adicionar à Tela de Início.

O iOS não mostra nenhum aviso de instalação próprio, então, se você está esperando um aparecer, ele não vai. O menu Compartilhar é o mecanismo inteiro.

Guia completo: iPhone e iPad

Servidores, sessões SSH e scripts

npx realtimeclipboard D75LV

Para máquinas sem área de transferência e sem tela. Ele lê a entrada padrão e escreve na saída padrão, então se combina com todo o resto:

echo "deploy key" | npx realtimeclipboard send D75LV
npx realtimeclipboard watch D75LV --once > token.txt

Precisa do Node 22 ou mais novo. Não é uma implementação separada — ele importa os mesmos arquivos de criptografia e transporte que o navegador roda, então um trecho enviado de um servidor é indistinguível de um enviado por um notebook.

Guia completo: a linha de comando

Rodar o seu próprio retransmissor

O retransmissor passa trechos criptografados entre os seus dispositivos. Ele não consegue lê-los — só enxerga um hash de sala e texto cifrado — mas, se você prefere não aceitar isso na confiança, rode um você mesmo:

docker run -p 8000:8000 ghcr.io/akshaynikhare/realtimeclipboard-relay

Depois aponte o aplicativo para ele em Configurações → Retransmissor. Existe um docker-compose.yml com TLS automático e um chart Helm no diretório deploy. Fixe em uma réplica só, a menos que você tenha dado um Redis a ele.

Guia completo: rodar o seu próprio retransmissor

Pronto para instalar: a página de download. Algo errado ou desatualizado aqui? Abra uma issue.