UniClipboard

English | 简体中文 | 繁體中文 | 日本語 | Русский | Português (Brasil)

Quem mantém este projeto? (Sobre o projeto e confiança, em inglês)

Computador ↔ computador — sincronização bidirecional da área de transferência em tempo real.

_amd64.deb sudo apt-get install -f # resolve missing deps if any # Fedora / RHEL / openSUSE (one-shot, no COPR) sudo dnf install ./UniClipboard--1.x86_64.rpm # AppImage (any distro) chmod +x UniClipboard__amd64.AppImage ./UniClipboard__amd64.AppImage ``` > Instalações por COPR / Snap / rpm / deb não se atualizam por dentro do aplicativo: use o gerenciador de pacotes. No Linux, o atualizador interno é destinado ao AppImage. ### Homebrew (macOS) No macOS, instale pelo tap oficial [`UniClipboard/homebrew-tap`](https://github.com/UniClipboard/homebrew-tap): ```bash brew tap UniClipboard/tap # Homebrew 6.0+ requires you to trust third-party taps before it will load # their formulae/casks. Skip this and you'll hit # "Refusing to load ... from untrusted tap". It only needs to run once. brew trust UniClipboard/tap # Desktop app (.app bundle) brew install --cask uniclipboard # CLI only — installs the `uniclip` command brew install uniclipboard ``` Também é possível instalar diretamente sem adicionar o tap antes, mas ainda é preciso marcá-lo como confiável uma vez: ```bash brew trust UniClipboard/tap # Homebrew 6.0+, one-time brew install --cask UniClipboard/tap/uniclipboard # GUI brew install UniClipboard/tap/uniclipboard # CLI ``` O cask e a formula podem coexistir: instale ambos se quiser a interface gráfica e o comando `uniclip`. ### Atualização da versão 0.19.x A versão 1.0 converte os dados locais para um novo formato de armazenamento e proteção e usa um novo esquema de pareamento: - Atualize por cima da instalação existente usando o mesmo método. O histórico recebe backup automático na primeira execução, que pode demorar mais. - Não é possível voltar à versão 0.19 depois disso, e dispositivos nas versões 0.19 e 1.0 não sincronizam entre si. - Os pareamentos antigos são apagados. Quando todos os dispositivos estiverem na versão 1.0, faça o pareamento novamente na página **Dispositivos**. Veja o [guia de atualização de 0.19 para 1.0](https://docs.uniclipboard.app/migration/upgrade-0-19-to-v1) para a ordem recomendada, locais de backup e procedimentos de recuperação. ### Compilar a partir do código-fonte Pré-requisitos: a toolchain Rust fixada em `rust-toolchain.toml`, [Bun](https://bun.sh), [Go](https://go.dev) (versão em `apps/gui-go/go.mod`) e os [pré-requisitos do Wails v3](https://v3alpha.wails.io/getting-started/installation/) para seu sistema. O comando de desenvolvimento `bun wails:dev` funciona no macOS e no Windows. ```bash git clone https://github.com/UniClipboard/UniClipboard.git cd UniClipboard # Install dependencies bun install # Start development mode (isolated `dev` profile, so it doesn't touch an installed app's data) bun wails:dev # Build a local macOS app bundle apps/gui-go/build.sh ``` A estrutura do pacote está descrita em `apps/gui-go/README.md`. Veja [CONTRIBUTING.md](./CONTRIBUTING.md), em inglês, para desenvolvimento com vários dispositivos, testes e convenções do projeto. ## Como usar ### Primeiro dispositivo: criar um espaço 1. Abra o aplicativo, escolha **Este é meu primeiro dispositivo** e clique em **Criar novo espaço**. 2. Defina uma frase secreta de criptografia. Ela protege todos os dados do espaço e será necessária para adicionar dispositivos, por isso guarde-a com segurança. 3. Pronto. O conteúdo copiado é armazenado de forma criptografada nesse espaço. ### Adicionar dispositivos por convite 1. Em um dispositivo existente, abra **Dispositivos** e clique em **Convidar dispositivo** para gerar um código de curta duração. 2. No novo dispositivo, escolha **Já uso o UniClipboard em outro lugar** → **Entrar por pareamento** e informe o código de convite e a frase secreta do espaço. 3. Assim que o pareamento for confirmado, o dispositivo entra no espaço e a sincronização começa automaticamente. > Já terminou a configuração e quer mudar de espaço? Use **Entrar em outro espaço** na página Dispositivos ou execute `uniclip space join --switch` na CLI. O histórico local é migrado para o novo espaço. Sem `--switch`, `uniclip space join` faz um novo pareamento não destrutivo, sem trocar de espaço. ### Conectar um celular O **[aplicativo móvel UniClipboard](https://github.com/UniClipboard/UniClip)** atende **iOS** ([beta público no TestFlight](https://testflight.apple.com/join/nyNQ8dQe)) e **Android** ([downloads de APK](https://github.com/UniClipboard/UniClip/releases/latest)). No computador, abra **Dispositivos** e clique no ícone de telefone para abrir **Conectar celular**, que oferece dois métodos: - **Sincronização normal** (padrão) — modo de compatibilidade HTTP. O daemon do computador executa um pequeno serviço HTTP compatível com SyncClipboard; a janela registra o telefone e mostra um QR code com endereço e credenciais de uso único para o aplicativo ler. - **Conexão de dispositivo (experimental)** — o telefone entra no espaço criptografado por um código de convite, como outro computador. Limitações da sincronização normal: - **Não é P2P** — o telefone é um cliente HTTP comum, sem travessia de NAT ou retransmissão. Funciona na rede local; para outras redes, use um [nó de servidor sem interface gráfica](https://docs.uniclipboard.app/guides/self-host-server-node) com HTTPS público ou uma rede Tailscale / VPN. - **HTTP sem criptografia + Basic Auth no serviço** — habilite apenas em redes confiáveis ou use um proxy reverso com TLS. - **O telefone não é membro do espaço** — não recebe ID de nó e não acessa o banco criptografado do histórico. - **Sem sincronização silenciosa em segundo plano no iOS** — o sistema não oferece um mecanismo geral de monitoramento da área de transferência em segundo plano. O aplicativo sincroniza em primeiro plano ou por extensões de teclado e compartilhamento. Veja [FAQ sobre sincronização em segundo plano no iOS](https://docs.uniclipboard.app/help/faq#why-cant-the-ios-app-sync-clipboard-silently-in-the-background-like-the-desktop). > ⚠️ Se o TestFlight mostrar erro de certificado ou o botão **Instalar** ficar carregando sem parar, desative temporariamente seu proxy / VPN, incluindo regras globais, TUN e descriptografia HTTPS / MitM, para permitir conexão direta. Ative novamente após instalar. Veja o [guia do aplicativo móvel](https://docs.uniclipboard.app/mobile) e o [guia de sincronização móvel no computador](https://docs.uniclipboard.app/core-features/mobile-sync) para o processo completo. ### Páginas principais - **Histórico** — histórico da área de transferência com pesquisa de texto completo, filtros e prévias detalhadas - **Painel rápido** — sobreposição acionada por atalho para acessar o conteúdo rapidamente - **Dispositivos** — convites, conexão de celulares, estado da conexão, controle individual de sincronização e troca ou recriação de espaços - **Configurações** — geral, aparência, atalhos, painel rápido, sincronização, segurança, rede, armazenamento (incluindo backups de atualização) e informações do aplicativo ## Recursos avançados ### Como funciona ```mermaid flowchart LR subgraph A["Dispositivo A (seu notebook)"] direction TB CC["Ctrl+C"] --> EA["criptografar
(sua chave)"] end subgraph B["Dispositivo B (seu computador)"] direction TB DB["descriptografar
(sua chave)"] --> CV["Ctrl+V"] end EA -->|"P2P por travessia de NAT"| DB EA -.->|"se não houver conexão direta"| R["Retransmissor
(vê apenas
dados criptografados)"] R -.-> DB ``` - **Pareamento**: um novo dispositivo entra com um código de convite de uso único e a frase secreta do espaço. Sem conta na nuvem nem e-mail. - **Transporte**: conexão direta quando os dispositivos são acessíveis entre si, na mesma rede ou por travessia de NAT; caso contrário, retransmissão criptografada. - **Criptografia**: a criptografia do conteúdo independe do transporte. Até um retransmissor mal-intencionado vê apenas dados criptografados. - **Armazenamento**: histórico local, prévias e índice de pesquisa são criptografados em repouso. - **Resiliência**: as conexões se recuperam automaticamente após mudanças de rede, suspensão ou desconexões breves. Também é possível atualizar a conexão de um dispositivo na página Dispositivos. **Componentes.** O aplicativo tem três partes: a interface gráfica (Go/Wails + React), o daemon em segundo plano `uniclipd`, que sincroniza e armazena o conteúdo, e a CLI `uniclip`. A interface gráfica e a CLI conversam com o mesmo daemon local por uma API HTTP / WebSocket de loopback e mostram o mesmo estado. Sincronização, criptografia e armazenamento ficam no repositório separado [UniClipboard Engine](https://github.com/UniClipboard/Engine), cuja revisão é fixada no `Cargo.toml` deste repositório. ### Ferramenta de linha de comando A CLI `uniclip` funciona com ou sem a interface gráfica, inclusive em servidores. Comandos comuns: ```bash uniclip space init # Create a new encrypted space on this device uniclip space invite # Generate a short-lived invitation code uniclip space change-passphrase # Change the space passphrase (unlocked, single-device space) uniclip space join --code # Join a space (re-pair, non-destructive) uniclip space join --switch --code # Switch to another space uniclip space status # Inspect the active space and daemon uniclip member list # List paired devices and presence uniclip send "hello" # Send text to other devices uniclip send ./report.pdf # Send an existing file printf '%s\n' ./a.png './b c.pdf' | uniclip send --file # Send paths from stdin uniclip send --text report.pdf # Force an existing filename to be sent as text uniclip get # Fetch the latest entry uniclip get --wait # Wait for the next synced entry uniclip get --copy # Copy the latest entry to this computer's clipboard uniclip search "invoice" # Search clipboard history uniclip run # Foreground daemon lifecycle uniclip service start / restart / status / stop # User service lifecycle ``` Execute `uniclip --help` para a lista completa ou consulte a [referência da CLI](https://docs.uniclipboard.app/cli/reference). ### Privacidade e segurança **O que coletamos** — dois canais anônimos e separados: diagnóstico (falhas, erros e logs com dados sensíveis removidos) e análise de uso (eventos como resultados de configuração e sincronização). Eles nunca incluem conteúdo da área de transferência, nomes ou caminhos de arquivos, frases secretas, chaves ou termos pesquisados. Ambos ficam ativos por padrão; o aviso da primeira execução permite desativá-los, e cada um pode ser controlado em **Configurações → Geral → Privacidade**. Os campos exatos estão em [Privacidade e coleta de dados](https://docs.uniclipboard.app/core-features/privacy). **O que um retransmissor pode ver** — bytes criptografados e metadados da conexão, como IDs dos pares de origem e destino. Ele não consegue descriptografar seu conteúdo. **O que fica no disco** — um banco SQLite e um índice de pesquisa criptografados. Texto, títulos, prévias, tags e nomes de arquivos são criptografados antes da gravação. **Se perder um dispositivo** — remova-o de outro dispositivo pareado. Os demais param de enviar novos conteúdos para ele. **Você pode auditar** — o aplicativo e o [Engine](https://github.com/UniClipboard/Engine), incluindo a criptografia, têm código aberto no GitHub. #### Detalhes da criptografia - **XChaCha20-Poly1305 AEAD** protege o conteúdo com nonce aleatório de 24 bytes e chaves de 256 bits, oferecendo confidencialidade e verificações de integridade e autenticidade. - **Argon2id** deriva o material de criptografia das chaves a partir da frase secreta do espaço (padrão: 128 MiB de memória, 3 iterações e 4 vias), dificultando ataques com GPU / ASIC. - **Chaves em camadas**: as chaves do conteúdo ficam em um cofre criptografado por perfil. O armazenamento seguro do sistema (macOS Keychain, Windows Credential Manager e Linux Secret Service) guarda somente o material para desbloqueio automático. Se ele for perdido, a frase secreta original restaura o acesso. - **Isolamento por espaço**: cada espaço tem suas próprias chaves. ## Perguntas frequentes

Por que não usar apenas a Área de Transferência Universal do iCloud?

Se você usa apenas dispositivos Apple, não precisa de histórico e confia totalmente na criptografia de ponta a ponta de código fechado da Apple, o iCloud atende. Ao adicionar Windows ou Linux, precisar pesquisar o histórico ou querer verificar a criptografia por conta própria, será necessário outro recurso.

Por que não usar uma solução de sincronização auto-hospedada, como ClipCascade?

Uma solução auto-hospedada exige manter um servidor. O UniClipboard funciona de imediato: prioriza P2P direto e usa retransmissão criptografada somente como alternativa. Você não precisa operar infraestrutura.

Funciona na rede local sem retransmissor?

Dispositivos acessíveis na mesma rede se conectam diretamente. **Configurações → Rede → Modo somente LAN** desativa completamente a alternativa por retransmissor; com esse modo, dispositivos em redes diferentes não conseguem se conectar. Veja no [FAQ](https://docs.uniclipboard.app/help/faq) quais acessos à internet ainda ocorrem nesse modo.

Onde meu histórico realmente fica armazenado?

Somente nos seus dispositivos, criptografado em repouso. Nenhum servidor do UniClipboard recebe ou armazena o conteúdo da sua área de transferência.

Existe um aplicativo para celular?

Sim — o **[aplicativo móvel UniClipboard](https://github.com/UniClipboard/UniClip)** atende iOS e Android. Ele usa sincronização normal por padrão e oferece um modo experimental de conexão de dispositivo para entrar no espaço por convite. Veja [Conectar um celular](#mobile-companion-lan).

Atualizei da versão 0.19 e meus dispositivos pararam de sincronizar. O que aconteceu?

Isso é esperado: a versão 1.0 usa um novo esquema de pareamento, apaga os antigos e não permite parear dispositivos 0.19 e 1.0. Atualize todos para 1.0 e pareie novamente. Veja o [guia de atualização](https://docs.uniclipboard.app/migration/upgrade-0-19-to-v1).

## Como contribuir Todas as formas de contribuição são bem-vindas! Leia [CONTRIBUTING.md](./CONTRIBUTING.md), em inglês, para configuração de desenvolvimento, estratégia de branches, convenções de commit e processo de PR. Primeiros passos: 1. Faça um fork deste repositório. 2. Crie uma branch para sua alteração (`git checkout -b feature/amazing-feature`). 3. Faça commits seguindo as [convenções do projeto](./CONTRIBUTING.md#commit-conventions). 4. Envie a branch (`git push origin feature/amazing-feature`). 5. Abra um Pull Request para a branch `main`. ## Licença Este projeto usa a licença AGPL-3.0. Veja [LICENSE](./LICENSE) para os detalhes. ## Agradecimentos - [Wails](https://wails.io) — framework de aplicativos multiplataforma - [React](https://react.dev) — framework de desenvolvimento de interfaces - [Rust](https://www.rust-lang.org) — linguagem segura e eficiente para o backend - [iroh](https://www.iroh.computer) — rede P2P baseada em QUIC que permite conexões diretas entre redes e transferência de blobs - [Tokio](https://tokio.rs) — runtime assíncrono que executa as operações de rede e de entrada e saída - [shadcn/ui](https://ui.shadcn.com) — componentes combináveis construídos sobre Radix UI - [Radix UI](https://www.radix-ui.com) — primitivas acessíveis sem estilo predefinido usadas na interface - [Tailwind CSS](https://tailwindcss.com) — estilização de toda a interface baseada em classes utilitárias - [SQLite](https://www.sqlite.org) — banco embutido que armazena o histórico localmente ## Comunidade Converse com outros usuários e com a equipe de desenvolvimento:

Grupo do QQ	Grupo do WeChat	Grupo do Telegram

--- **Tem perguntas ou sugestões?** [Abra uma Issue](https://github.com/UniClipboard/UniClipboard/issues/new) ou entre em contato para conversar!