ZipStream
Aplicativo desktop multiplataforma (Windows, Linux, macOS) para compactar e transferir arquivos e pastas direto entre dois computadores (P2P), sem armazenar nada em nuvem e com criptografia ponta a ponta (E2EE).
O que ele faz
- Envia arquivos ou pastas de qualquer tamanho: compacta em streaming (zstd), cifra e envia direto para o outro computador.
- Código de envio de 6 caracteres para parear os dois lados e código de segurança (SAS) para conferir que ninguém está no meio.
- Retomada automática: se a conexão cair, reconecta e continua de onde parou. Funciona inclusive depois de fechar e reabrir o app (lista "Envios/Recebimentos interrompidos" → Retomar).
- Escolha onde salvar ao receber (padrão:
Downloads); nunca sobrescreve — usa nome (1), nome (2)...
- Menu de contexto "Enviar com ZipStream" no gerenciador de arquivos (Windows; Linux e macOS em melhor esforço): abre só um painel compacto com o código já copiado para a área de transferência.
- Fica na bandeja do sistema (área de notificação no Windows/Linux, barra de menus no macOS): fechar a janela não interrompe transferências; Sair fica no menu do ícone. Uma única instância por usuário — novos pedidos vão para a que já está aberta.
- Log técnico com o que aconteceu em cada etapa (conexão, ICE, transferência, erros), com Copiar e Exportar.
- Ferramentas: compactar/descompactar
.zpp2 localmente, sem rede.
- Temas claro/escuro e idiomas en-US, pt-BR e es-ES.
Como usar
Enviar
- Aba Enviar → arraste um arquivo ou pasta, ou use Escolher arquivo / Escolher pasta.
(Ou clique com o botão direito no arquivo → Enviar com ZipStream: aparece um painel no canto da tela com o código já copiado.)
- Gerar código e enviar → passe o código de envio para quem vai receber.
- Quando o outro lado conectar, confira se o código de segurança é o mesmo nas duas telas.
Receber
- Aba Receber → digite o código de envio.
- Em Salvar em, escolha a pasta (fica lembrada para as próximas vezes).
- Receber → ao final, Abrir pasta.
Se algo der errado
- O painel de status mostra uma explicação e o detalhe técnico; Ver log abre o log completo.
- Transferências interrompidas aparecem na aba correspondente com Retomar (os dois lados precisam retomar; o código é o mesmo).
Arquitetura
[App Origem] ──DataChannel P2P (libdatachannel)── [App Destino]
│ │
└────── SignalR (sinalização) ────────────────┘
│
[Servidor de sinalização]
+ coturn (TURN/STUN, fallback)
O servidor só pareia os dois lados (troca de SDP/candidatos ICE; no máximo 2 dispositivos por código). O arquivo vai direto entre as máquinas (ou via relay TURN quando o P2P direto é bloqueado), sempre cifrado com AES-256-GCM.
Protocolo de transferência
Cada pacote .zpp2 (zstd em chunks com SHA-256) é enviado em mensagens de até 60 KiB:
- Troca de chaves ECDH P-256 → chave AES-256-GCM + código SAS.
- Remetente envia o cabeçalho (id da transferência, nome, tamanho).
- Destinatário responde com quantos bytes desse id já tem (retomada).
- Remetente envia os chunks com controle de fluxo (no máximo 8 MB sem confirmação); o destinatário confirma (
Ack) o que gravou em disco e, ao final, envia Done.
- Queda de conexão ou 30 s sem resposta → reconexão automática com backoff, retomando do último byte confirmado.
O estado das transferências em andamento fica em %LOCALAPPDATA%/ZipStream/transfers (Linux: ~/.local/share/ZipStream/transfers; macOS: ~/Library/Application Support/ZipStream/transfers).
Projetos
| Projeto | Papel |
|---|
src/ZipP2P.Core | Motor de compressão (zstd streaming, formato .zpp2) + criptografia (ECDH/AES-GCM/SAS) |
src/ZipP2P.P2P | Transporte (libdatachannel), sinalização, protocolo de transferência, reconexão e estado persistido |
src/ZipP2P.Contracts | DTOs compartilhados (cliente/servidor) |
src/ZipP2P.Server | Servidor de sinalização (ASP.NET Core + SignalR) |
src/ZipP2P.App | Aplicativo desktop (Avalonia) |
tests/ZipP2P.Core.Tests | Testes do motor e da criptografia |
tests/ZipP2P.P2P.Tests | Protocolo, retomada, reconexão e integração ponta a ponta via WebRTC |
tests/ZipP2P.App.Tests | Log, linha de comando e integração com o menu de contexto |
Requisitos
- .NET 10 SDK
- (opcional, para relay) Docker — para o coturn
Como rodar
Servidor de sinalização
dotnet run --project src/ZipP2P.Server
Escuta em http://0.0.0.0:5000 (hub em /signaling). Para a mesma rede, também dá para usar o servidor embutido no app: ⚙️ Configurações → Iniciar servidor local.
Aplicativo
dotnet run --project src/ZipP2P.App
Linha de comando:
| Argumento | Efeito |
|---|
--send <caminho> | Abre o painel compacto e já começa a enviar (usado pelo menu de contexto) |
--receive <código> | Abre a aba Receber com o código preenchido |
<caminho> | Igual a --send |
As configurações ficam em SQLite (%LOCALAPPDATA%/ZipStream/settings.db) e são editadas em ⚙️ Configurações: URL do servidor, porta do servidor local, menu de contexto. A pasta de destino é lembrada pela aba Receber.
Testar na mesma rede (2 máquinas)
- Máquina A: ⚙️ Configurações → Iniciar servidor local (mostra o endereço, ex.:
http://192.168.0.10:5000/signaling).
- Máquina B: ⚙️ Configurações → URL do servidor = endereço da máquina A → Salvar.
- Uma máquina Envia (gera o código), a outra Recebe com o código.
Instalação
Cada release (tag v*) gera pelo GitHub Actions:
| Arquivo | Sistema |
|---|
ZipStream-Setup-<versão>-win-x64.exe | Windows — instalador (Inno Setup), por usuário, sem administrador; opção de já adicionar o menu de contexto |
zipstream_<versão>_amd64.deb | Debian/Ubuntu/Mint — sudo apt install ./zipstream_<versão>_amd64.deb; instala em /opt/zipstream, atalho no menu e comando zipstream |
ZipStream-win-x64.zip, ZipStream-linux-x64.tar.gz, ZipStream-osx-x64.tar.gz | Versões portáteis |
Para gerar uma release: git tag v1.2.3 && git push origin v1.2.3. Rodando o workflow manualmente (Actions → Release → Run workflow), os pacotes ficam nos artefatos da execução, sem criar release.
Deploy do servidor (VPS com Docker)
deploy/docker-compose.yml sobe o servidor de sinalização e o coturn (TURN). O HTTPS fica com um reverse proxy que já rode na VPS (ex.: Caddy): o servidor entra na network externa proxy (docker network create proxy, se ainda não existir) com o alias zipstream-server. No Caddyfile, com o proxy também nessa network:
zipstream.seudominio.com {
reverse_proxy zipstream-server:5000
}
git clone https://github.com/igoreusttaquio/ZipStream-P2P.git && cd ZipStream-P2P/deploy
cp .env.example .env # PUBLIC_IP e TURN_PASSWORD
docker compose up -d --build # atualizar: git pull && docker compose up -d --build
Firewall: liberar 3478/tcp+udp e 49160-49200/udp (80/443 já são do Caddy). Teste: https://zipstream.seudominio.com responde "ZipStream signaling server".
Testar entre redes (TURN/relay)
- Suba o servidor e o coturn (seção acima).
- Nas duas máquinas, URL do servidor =
https://zipstream.seudominio.com/signaling.
- ⚙️ Configurações → Servidor STUN/TURN: host
zipstream.seudominio.com:3478, usuário zipstream e a senha do TURN_PASSWORD → Salvar. Sem usuário, o servidor vale só como STUN. Sem nada configurado, o app usa o STUN público do Google (stun.l.google.com:19302), suficiente para a maioria das redes; o TURN só é necessário quando a conexão direta é bloqueada.
Menu de contexto
⚙️ Configurações → Menu de contexto → Instalar / Remover.
| Sistema | Como é instalado | Observações |
|---|
| Windows | HKCU\Software\Classes\*\shell e Directory\shell (sem administrador) | No Windows 11 fica em "Mostrar mais opções" |
| Linux | Scripts do Nautilus e Caja, ação do Nemo, service menu do Dolphin | Melhor esforço; pode ser preciso reiniciar o gerenciador (nautilus -q) |
| macOS | Ação Rápida do Automator em ~/Library/Services | Experimental; melhor com o app em /Applications |
Se o app mudar de lugar, Configurações mostra que a entrada aponta para outra cópia — é só clicar em Instalar de novo.
No Linux, o ícone da bandeja usa o protocolo StatusNotifierItem (KDE, Cinnamon, XFCE...); no GNOME é preciso a extensão AppIndicator. Sem bandeja, abrir o app de novo traz a janela de volta.
Problemas comuns
- "You must install or update .NET" ao abrir (rodando pelo código-fonte): o app usa os runtimes
Microsoft.NETCore.App e Microsoft.AspNetCore.App (servidor embutido). Instalar só o ASP.NET Core de uma versão mais nova que o .NET Runtime quebra a resolução — instale o .NET Runtime da mesma versão (dotnet --list-runtimes mostra o que há). Os pacotes do release já trazem o runtime.
- "No precompiled XAML found": build interrompido (ex.: compilar pela linha de comando com o app aberto pelo Visual Studio). Faça Rebuild.
Testes
dotnet test
Roadmap (resumido)
Detalhes no plan.md.
