O receptor de computador

Antes de começar

Você precisa de um computador Windows ou Linux que fique ligado enquanto recebe. Para o login business e o modo no local, é preciso o plano Business. O modo pessoal pareia com o link de pareamento do seu próprio celular e não precisa de conta.

Passos

• Baixe o instalador do Windows (NSIS) ou o AppImage ou o pacote deb do Linux na página de download e confira a soma SHA-256 publicada ao lado. Por enquanto as versões não são assinadas, então espere que o sistema operacional avise você uma vez. No Windows, o SmartScreen mostra “O Windows protegeu o computador”: clique em Mais informações e depois em Executar assim mesmo. O instalador pede permissão de administrador uma vez, instala para todos os usuários do computador e abre o firewall para este app nas redes privadas, públicas e de domínio. No Ubuntu 24.04 um AppImage só inicia se você o executar com --no-sandbox (./WhispShare-Receiver-…AppImage --no-sandbox), porque o Ubuntu 24.04 restringe o sandbox de que o Chromium precisa; o pacote deb configura isso para você e inicia normalmente.
• Escolha como este computador recebe: login business com um código de dispositivo de 8 caracteres que o titular aprova no navegador dele; modo pessoal («Parear com meu celular»), pareado com o link de pareamento do seu próprio celular; ou somente no local, para visitantes nesta rede Wi-Fi sem internet. No modo pessoal, o computador continua recebendo do seu celular mesmo sem nenhum navegador aberto: no celular, abra o WhispShare e inicie um pareamento, envie o link de pareamento para este computador (por e-mail ou em uma nota para você mesmo), cole-o na tela «Parear meu celular» (o menu da bandeja tem a mesma opção até que algo esteja pareado) e toque em «Parear com meu celular». O celular e o computador precisam estar online enquanto um arquivo é enviado. Este computador espera como a outra ponta de um pareamento que o seu celular inicia; ele não mostra um QR próprio.
• Escolha a pasta de salvamento. Cada sessão cai em uma pasta própria, <pasta de salvamento>/<ano-mês>/<rótulo do link, nome da sala ou "Direct">/<data e hora> <nome do remetente ou "Visitor"> <últimos 4 caracteres do código da sessão>/, e cada arquivo ganha um registro complementar ao lado, <file>.whispshare.json. O registro complementar anota a sessão, o nome e o dispositivo de quem envia, o link e seu rótulo, o nome do arquivo como foi enviado e como foi salvo, o tamanho, o tipo e o SHA-256 e, quando a transferência termina, os hashes de segmento verificados. Os textos e cartões enviados não ficam no registro complementar: o receptor os guarda no registro diário dele (received-<date>.jsonl na pasta de salvamento).
• Deixe o receptor rodando: ele fica na bandeja e pode iniciar com o computador. O menu da bandeja diz, com palavras, o que o receptor está fazendo (recebendo do seu celular, recebendo para a sua empresa, pausado, offline, aguardando a chave da caixa de entrada do administrador, ainda não pareado) e sempre oferece Alterar pasta de salvamento e Abrir pasta de salvamento; os mesmos dois botões ficam na parte de baixo da janela. O receptor segue o idioma do computador (inglês, árabe, alemão, espanhol, francês, hebraico, italiano, japonês, coreano, holandês, polonês, português do Brasil, romeno, turco ou chinês) e você pode escolher outro no menu da bandeja ou em Configurações.
• Para coletar os envios de uma sala, use “Entrar em uma sala”: o receptor fica na sala só de recebimento e salva o que os membros compartilham.
• Para este computador parar de receber, revogue o receptor nas configurações da empresa, ou escolha Desparear este dispositivo nas Configurações do próprio computador. Desparear libera a vaga do receptor no servidor com o token próprio dele e depois remove do computador o token, o pareamento, as salas e a chave da caixa de entrada. Se o servidor não puder ser alcançado, o computador fica desparado mesmo assim, e a janela informa que o servidor não confirmou a liberação: peça a um administrador para remover o receptor no console da empresa, ou a vaga continuará contada.

Onde as chaves ficam guardadas

A identidade do receptor e a chave da caixa de entrada são criptografadas com uma chave que fica na pasta de estado do receptor. O app de desktop protege essa chave com o armazenamento seguro do sistema operacional (DPAPI do Gerenciador de Credenciais do Windows, o chaveiro do macOS ou o chaveiro do Linux via libsecret ou KWallet). Essa chave fica presa a este computador e a esta conta de usuário pelo cofre de chaves do sistema operacional, então uma cópia da pasta de estado, feita de um backup, de um cliente de sincronização ou de uma imagem de disco, não leva a chave junto. Sobre mostra como as chaves são guardadas. Em um computador Linux sem chaveiro, a chave fica em um arquivo protegido (modo 0600) e Sobre informa isso; instale gnome-keyring ou KWallet para protegê-la. Se o chaveiro ainda estiver bloqueado logo após o login, o receptor espera cerca de meio minuto. Se depois não conseguir abrir as chaves (o chaveiro ou a conta foi redefinido), ele oferece sair ou recomeçar e parear de novo; nunca cria chaves novas em silêncio. O receptor sem interface (whispshare-receiver) não tem cofre de chaves do sistema operacional, então a pasta de estado dele (<folder>/.whispshare/) é a chave: quem copiá-la pode ler o que o receptor lê. Mantenha essa pasta fora de backups, clientes de sincronização e unidades compartilhadas, e deixe só a conta de serviço lê-la (modo 0700). Para mudar um receptor para outra máquina, pareie um novo. whispshare-receiver --help diz o mesmo.

O que o outro lado vê

Um cliente vê a empresa como “recebendo agora” enquanto o receptor está ligado, toca a campainha com um único cartão de solicitação e só envia arquivos ao vivo depois que uma pessoa ou um dispositivo de plantão confirma. O receptor em si nunca admite ninguém em uma sala e nunca envia uma liberação de sala; ele só salva, e mais nada. Pausar o recebimento fecha juntos a campainha, as salas e um pareamento pessoal; as transferências que já estão em andamento terminam e as novas ofertas esperam até você retomar.

Se algo der errado

Um receptor desligado não está recebendo: a página do link avisa isso, e só o único cartão de solicitação pode esperar. No modo presencial, o navegador do visitante mostra um aviso de certificado para o endereço local; esse aviso é esperado em uma rede sem internet — diga isso com clareza e mostre ao visitante o cartão do local para que ele possa comparar. Se a pasta de salvamento encher ou mudar de lugar, escolha uma pasta nova e volte a receber; uma transferência maior que o espaço livre é recusada antes de começar. Se os celulares não alcançam o endereço local, abra o painel do modo presencial. Ele mostra a rede em que o Windows colocou o computador e avisa quando a regra do firewall está faltando ou não cobre essa rede (“marque Redes públicas” no aviso do Windows, ou reinstale para todos os usuários). Quando o computador tem vários endereços (Wi-Fi, uma VPN, WSL ou Docker), escolha ali o do Wi-Fi para o QR code. Para relatar um problema, abra Configurações, depois Sobre, depois Copiar diagnóstico, e cole o texto na sua mensagem. Ele traz só versões, estados e contagens: nenhum nome de arquivo, chave ou endereço. O receptor também guarda um pequeno registro rotativo do mesmo tipo na pasta de logs do sistema operacional.

Limites

O receptor aumenta o limite de tamanho das transferências ao vivo: 2 GiB no modo pessoal, 20 GiB com o Away e 50 GiB com o Business, enquanto um navegador fica em 2 GiB e um iPhone em 1 GiB. Os limites do modelo continuam valendo para uma sessão confirmada: documentos com até 10 arquivos e 50 MB, uma confirmação com um arquivo e 500 MB, a menos que o link defina os próprios limites. O receptor procura uma versão nova uma vez por dia e mostra um aviso; baixe e instale à mão na página de download. O receptor headless (whispshare-receiver) pode enviar com POST cada arquivo recebido a um webhook local. Use-o só para este computador ou para a rede do seu escritório: a requisição informa o caminho salvo, o arquivo e quem o enviou. Defina um segredo (--webhook-secret) e a requisição leva uma assinatura HMAC, e um envio que falha é tentado de novo três vezes.

Relacionados

• Business: a caixa de entrada compartilhada
• Baixar
• Compartilhar sem internet