iWant

Compartilhamento de arquivos descentralizado peer-to-peer baseado em CLI

Status da Build

O que é?

Uma ferramenta de linha de comando para buscar e baixar arquivos em rede LAN, sem servidor central.

Funcionalidades

• Descentralizado : Não há servidor central hospedando arquivos. Portanto, sem ponto único de falha
• Descoberta fácil de arquivos: Tão fácil quanto pesquisar algo no Google.
• Download de arquivos de vários peers: Se o seeder falhar/sair do grupo, o leecher continuará baixando de outro seeder na rede
• Download de diretórios: Suporta download de diretórios
• Retomar download: Retomar o download de onde parou.
• Dados consistentes: Quaisquer alterações (modificação, exclusão, adição) feitas em arquivos dentro da pasta compartilhada serão refletidas instantaneamente na rede
• Multiplataforma: Funciona em Linux/Windows/Mac. Mais testes precisam ser feitos no Mac

Por que eu construí isso ?

• Gosto da ideia de digitar algum nome de arquivo no terminal e baixá-lo se as pessoas ao meu redor o tiverem.
• Sem registro de terceiros.
• Sem configuração complicada.
• Queria que fosse multiplataforma.
• Zero tempo de inatividade.
• Sem navegador... só terminal
• Por diversão ¯\(ツ)/¯

Instalação

pip install iwant

Ou, se você baixar do código fonte

python setup.py install --user

Dependências do Sistema

Certifique-se de ter as seguintes dependências de sistema instaladas:

• libffi-dev
• libssl-dev

Uso

iWant.

    A commandline tool for searching and downloading files in LAN network, without any central server.


Usage:
    iwanto start
    iwanto search <name>
    iwanto download <hash>
    iwanto share <path>
    iwanto download to <destination>
    iwanto view config
    iwanto --version

Options:
    -h --help                           Show this screen.
    --version                           Show version.
    start                               This starts the iwant server in your system
    search <name>                       Discovering files in the network. Example: iwanto search batman
    download <hash>                     Downloads the file from the network
    share <path>                        Change your shared folder
    view config                         View shared and download folder
    download to <destination>           Change download folder

Nota: As pastas compartilhada e de download não podem ser iguais

Como executar

Execute iwanto start (isso executa o serviço iwant).

Executando o cliente

Para executar serviços como busca, download, visualizar configuração e alterar configuração, abra outro terminal e certifique-se de que o servidor iwant está em execução.

Executando o servidor

No Windows, é necessário acesso de administrador para executar o servidor

iwanto start

Buscar arquivos

Digite o nome do arquivo ;) (P.S Não precisa de nomes exatos)

iwanto search <filename>

Exemplo:

iwanto search "slicon valey"

Baixar arquivos

Para baixar o arquivo, basta inserir o hash do arquivo obtido após a busca.

iwanto download <hash of the file>

Exemplo:

iwanto download b8f67e90097c7501cc0a9f1bb59e6443

Alterar pasta compartilhada

Altere a pasta compartilhada a qualquer momento (mesmo quando o serviço iwant estiver em execução)

iwanto share <path>

Exemplo:

iwanto share /home/User/Movies/

No Windows, use aspas:

iwanto share "C:\Users\xyz\books\"

Alterar pasta de downloads

Altere a pasta de download a qualquer momento

iwanto download to <path>

Exemplo:

iwanto download to /home/User/Downloads

No Windows, use aspas:

iwanto download to "C:\User\Downloads"

Visualizar pasta compartilhada/de download

iwanto view config

Como funciona ?

Assim que o programa é iniciado, ele cria o daemon de eleição, daemon de monitoramento de pasta e daemon de servidor.

1. O daemon de eleição cuida das seguintes atividades

   • Gerencia o consenso.
   • Notifica o daemon de servidor assim que há uma mudança de líder.
   • Coordena com outros peers na rede em relação a eleições contestadas, indisponibilidade de líder, falha de rede, situação de split brain, etc.
   • Usa multicast para descoberta de peers. A descrição do consenso está mencionada aqui

2. Quando o daemon de monitoramento de pasta inicia, ele executa as seguintes etapas

   • Indexa todos os arquivos na pasta compartilhada
   • Atualiza as entradas no banco de dados
   • Informa o servidor sobre os arquivos e pastas indexados.
   • Quaisquer alterações feitas na pasta compartilhada acionam o daemon de monitoramento de pasta para indexar os arquivos modificados, atualizar o banco de dados e depois informar o servidor sobre as alterações

3. O cliente iwant comunica-se com o daemon de servidor quando o usuário deseja:

   • buscar arquivos
   • baixar arquivos
   • alterar pasta compartilhada
   • alterar pasta de download

4. O daemon de servidor recebe comandos do cliente iwant e atualizações do daemon de monitoramento de arquivos e eleição.

   • Atualizações recebidas do daemon de monitoramento de pasta são encaminhadas ao líder. Por exemplo: informações de arquivos/pastas indexados.
   • Atualizações recebidas do daemon de eleição como evento de mudança de líder acionam o servidor para encaminhar as informações de arquivos/pastas indexados para o novo líder
   • Consultas recebidas do cliente iwant como busca de arquivo são encaminhadas ao líder, que então realiza uma busca difusa nos metadados recebidos de outros peers e retorna uma lista contendo (nome do arquivo, tamanho, checksum)
   • Consultas recebidas do cliente iwant como download de arquivo são encaminhadas ao líder, que encaminha o roothash do arquivo/pasta juntamente com a lista de peers que possuem o arquivo. O então inicia o processo de download com os peers mencionados na lista de peers.

Tarefas

• Incorporar mecanismos de segurança robustos
• Adicionar suporte ao Python3
• Adicionar pré-visualização de vídeo
• Adicionar funcionalidade de streaming
• Adicionar travessia básica de NAT
• Criar módulos de teste
• Melhorar a interface da barra de progresso de download de arquivos/pastas

Por que pode não funcionar?

• Firewall
• Multicast não suportado no seu roteador.

Erros

Todos os logs estão presentes em ~/.iwant/.iwant.log ou AppData\Roaming\.iwant\.iwant.log

Gostou do projeto?

Qualquer ideia, bug ou modificação necessária, sinta-se à vontade para me enviar um PR :)