webtorrent desktop

Área de trabalho WebTorrent

O aplicativo de streaming de torrent. Para Mac, Windows e Linux.

Instalar

Instalação recomendada

Baixe a versão mais recente do WebTorrent Desktop do site oficial:

Baixar WebTorrent Desktop

Instalação avançada

• Baixe arquivos de instalação específicos na página de lançamentos do GitHub.

• Use Homebrew-Cask para instalar a partir da linha de comando:

   $ brew install --cask webtorrent
  

• Experimente a versão de desenvolvimento (instável) clonando o repositório Git. Consulte as instruções "Como contribuir".

Capturas de tela

Como contribuir

Obtenha o código

 $ git clone https://github.com/webtorrent/webtorrent-desktop.git
$ cd webtorrent-desktop
$ npm install

Execute o aplicativo

 $ npm start

Observe o código

Reinicie o aplicativo automaticamente sempre que o código for alterado. Útil durante o desenvolvimento.

 $ npm run watch

Execute linters

 $ npm test

Execute testes de integração

 $ npm run test-integration

Os testes de integração usam Spectron e Tape. Eles clicam no aplicativo, fazem capturas de tela e comparam cada uma com uma referência. Por que capturas de tela?

• A verificação ad-hoc torna os testes muito mais trabalhosos para escrever
• Mesmo a comparação de todo o HTML não é tão completa quanto a comparação de capturas de tela. Por exemplo, ele não detectaria um bug em que pressionar ESC em um vídeo não restaurasse corretamente o tamanho da janela.
• Os próprios testes de integração do Chrome usam iirc de diferenciação de captura de tela
• Pequenas alterações na interface do usuário interromperão alguns testes, mas a correção é tão fácil quanto excluir as capturas de tela ofensivas e executar os testes, que irão recriá-los com o novo visual.
• O Github PR resultante mostrará, pixel por pixel, as alterações exatas na interface do usuário que foram feitas! Consulte https://github.com/blog/817-behold-image-view-modes

Para MacOS, você precisará de uma tela Retina para passar nos testes de integração. Sua tela deve ter a mesma resolução de um MacBook Pro 13" 2018.

Para Windows, você precisará do Windows 10 com tela de 1366x768.

Ao executar testes de integração, mantenha o mouse na borda da tela e não toque no mouse ou no teclado enquanto os testes estiverem em execução.

Empacote o aplicativo

Cria binários de aplicativos para Mac, Linux e Windows.

 $ npm run package

Para construir para uma plataforma:

 $ npm run package -- [platform] [options]

Onde [platform] é darwin , linux , win32 ou all (padrão).

Os seguintes argumentos opcionais estão disponíveis:

• --sign - Assine o aplicativo (Mac, Windows)
• --package=[type] - Tipo de saída único do pacote.
  • deb - pacote Debian
  • rpm - pacote RedHat
  • zip - arquivo zip do Linux
  • dmg - imagem de disco Mac
  • exe - instalador do Windows
  • portable - aplicativo portátil do Windows
  • all - Todas as plataformas (padrão)

Nota: Mesmo com a opção --package , os arquivos de atualização automática (.nupkg para Windows, -darwin.zip para Mac) sempre serão produzidos.

Notas de compilação do Windows

O aplicativo do Windows pode ser empacotado em qualquer plataforma.

Observação: a assinatura de código do Windows só funciona no Windows , por enquanto.

Nota: Para empacotar o aplicativo Windows de plataformas não Windows, Wine e Mono precisam estar instalados. Por exemplo, no Mac, primeiro instale o XQuartz e depois execute:

 $ brew install wine mono

(Requer o gerenciador de pacotes Homebrew.)

Notas de construção do Mac

O aplicativo Mac só pode ser empacotado no macOS .

Notas de compilação do Linux

O aplicativo Linux pode ser empacotado em qualquer plataforma.

Se estiver empacotando do Mac, instale as dependências do sistema com o Homebrew executando:

 npm run install-system-deps

Leituras recomendadas para começar a trabalhar no aplicativo

Electron (Framework para fazer aplicativos nativos para Windows, OSX e Linux em Javascript): https://electronjs.org/docs/tutorial/quick-start

React.js (Framework para trabalhar com Frontend UI): https://reactjs.org/docs/getting-started.html

Material UI (componentes React que implementam o Material Design do Google): https://material-ui.com/getting-started/installation

Privacidade

O WebTorrent Desktop coleta algumas estatísticas básicas de uso para nos ajudar a melhorar o aplicativo. Por exemplo, monitoramos o funcionamento do botão play. Com que frequência isso dá certo? Tempo esgotado? Mostrar um erro de codec ausente?

O aplicativo nunca envia nenhuma informação de identificação pessoal nem rastreia quais torrents você adiciona.

Licença

MIT. Direitos autorais (c) WebTorrent, LLC.