O WingDrive conecta diretamente seus próprios dispositivos. Não há um servidor WingDrive intermediário: as conexões usam Iroh/QUIC, com criptografia de ponta a ponta.

Emparelhe dois dispositivos

O emparelhamento usa um código de uso único. Um dispositivo o gera e o outro se conecta com ele.

12 palavras (um mnemônico BIP39): fácil de ler e digitar, funciona na mesma rede local.
QR code: contém as mesmas palavras e o ID do nó do dispositivo, funcionando entre redes e pela internet, com relay como alternativa.

Os códigos são válidos por cinco minutos e nunca são reutilizados.

No aplicativo desktop, abra Devices na barra lateral e escolha Pair device. Pela CLI:

# No primeiro dispositivo
wing network pair generate

# No segundo dispositivo
wing network pair join "brave lion sunset river eagle mountain forest ocean thunder crystal diamond phoenix"

# Acompanhe o progresso
wing network pair status

Segurança

Autenticação: os dispositivos comprovam sua identidade com assinaturas Ed25519.
Confidencialidade: todo o tráfego é criptografado com chaves de sessão.
Integridade: um desafio e resposta comprova que quem se conecta conhece o código.
Sigilo futuro: novas chaves são usadas em cada sessão.

Os dispositivos emparelhados enviam seu nome, tipo, sistema operacional e versão do aplicativo atuais sempre que se conectam, para que um dispositivo renomeado ou reinstalado apareça com a nova descrição.

Remova um emparelhamento

wing network devices
wing network revoke <device>

A revogação avisa o outro dispositivo, que também remove o emparelhamento. Um dispositivo offline mantém o emparelhamento até que você o remova nele.

Sincronização da biblioteca

A sincronização da biblioteca compartilha o índice, as etiquetas e os metadados entre dispositivos emparelhados, para que cada dispositivo possa navegar e pesquisar o que os outros têm. O conteúdo dos arquivos permanece onde está.

wing library sync-setup setup --action share-local   # no dispositivo que contém a biblioteca
wing library sync-setup setup --action join-remote   # no dispositivo que se conecta

A configuração oferece três ações: share-local (compartilhar esta biblioteca), join-remote (conectar-se a uma biblioteca do outro dispositivo) e merge.

Wingdrop

O Wingdrop envia arquivos para um dispositivo emparelhado:

wing network wingdrop send <device-id> ./photo.jpg

A sincronização de arquivos entre dispositivos, os links públicos de compartilhamento e o Wingdrop para dispositivos próximos não emparelhados estão planejados para o marco M4.