Syncord

                                                                  $$\ 
                                                                  $$ |
 $$$$$$$\ $$\   $$\ $$$$$$$\   $$$$$$$\  $$$$$$\   $$$$$$\   $$$$$$$ |
$$  _____|$$ |  $$ |$$  __$$\ $$  _____|$$  __$$\ $$  __$$\ $$  __$$ |
\$$$$$$\  $$ |  $$ |$$ |  $$ |$$ /      $$ /  $$ |$$ |  \__|$$ /  $$ |
 \____$$\ $$ |  $$ |$$ |  $$ |$$ |      $$ |  $$ |$$ |      $$ |  $$ |
$$$$$$$  |\$$$$$$$ |$$ |  $$ |\$$$$$$$\ \$$$$$$  |$$ |      \$$$$$$$ |
\_______/  \____$$ |\__|  \__| \_______| \______/ \__|       \_______|
          $$\   $$ |                                                  
          \$$$$$$  |                                                  
           \______/ 

Syncord é uma ferramenta de sincronização e armazenamento de arquivos baseada em CLI que usa o Discord como armazenamento de arquivos criptografado.

Ela permite enviar arquivos ou diretórios inteiros para o Discord, criptografá-los e particioná-los localmente e, posteriormente, baixá-los e reconstruí-los com segurança; tudo por meio de uma interface de linha de comando simples ou de um painel TUI opcional.

O Syncord é distribuído como um executável único (syncord.exe) criado com PyInstaller. O executável pode ser colocado diretamente no PATH do seu sistema e usado de qualquer lugar.

✨ Recursos

• 🔐 Criptografia de ponta a ponta

  • Os arquivos são criptografados localmente antes do envio.
  • A chave de criptografia nunca é armazenada no Discord.
  • Sem a chave, os dados não podem ser recuperados. Certifique-se de não alterá-la após o envio.

• 📦 Particionamento automático de arquivos

  • Arquivos grandes são divididos em partes (chunks).
  • As partes respeitam os limites de upload do Discord (limites do Discord: 8MB; tamanho do chunk: 5MB antes da criptografia; ~7MB após a criptografia).
  • Os arquivos são remontados perfeitamente no download, graças ao rastreamento de partições via SQLite.

• 📁 Upload de diretórios

  • Envie diretórios inteiros de uma só vez.
  • Baixe também o diretório inteiro e os subdiretórios.

• 🖥️ Projetado para CLI

  • Comandos simples e utilizáveis em scripts.
  • Funciona globalmente quando adicionado ao PATH.

• 🧭 Dashboard TUI

  • Interface interativa de terminal.
  • Visualize arquivos armazenados e informações de uso.

• 📊 Estatísticas de uso

  • Acompanhe envios, downloads e uso de armazenamento.

• 🗄️ Banco de dados local de metadados

  • Metadados baseados em SQLite.
  • Sem dependência apenas do histórico de mensagens do Discord.

📦 Instalação

Binário Pré-compilado (Recomendado)

1. Baixe o syncord.exe
2. Coloque-o em um diretório incluído no PATH do seu sistema
3. Verifique a instalação:

syncord --help

Agora o Syncord pode ser invocado de qualquer diretório.

⚙️ Configuração Inicial Obrigatória

⚠️ O Syncord requer configuração antes do primeiro uso.

Tanto o token do bot do Discord quanto a Guild ID são obrigatórios.

Configuração Necessária

• Token do bot do Discord.
• Guild ID do Discord (servidor onde os arquivos serão enviados).
• Chave de criptografia (gerada localmente).

Comando de configuração única

syncord setup --token YOUR_DISCORD_BOT_TOKEN --guild-id YOUR_GUILD_ID --encryption-key

Notas Importantes

• 🔑 A chave de criptografia é essencial.
• ❌ Perder a chave significa perda permanente de dados.
• 🔒 O Discord não consegue descriptografar ou recuperar seus arquivos.
• 🛑 O Syncord não funcionará sem um token e uma Guild ID válidos.

📤 Enviando Arquivos

Enviar um único arquivo

syncord upload file.ext

Enviar um diretório inteiro

syncord upload folder_name

Comportamento:

• Todos os arquivos dentro do diretório são processados.
• A estrutura de pastas é preservada logicamente.
• Cada diretório se torna seu próprio namespace de pastas do Syncord.

📥 Baixando Arquivos

syncord download folder_on_syncord/file

O Syncord irá:

1. Localizar todas as partições necessárias.
2. Baixá-las do Discord.
3. Descriptografar localmente.
4. Remontar o arquivo original.

NOTA: Se nenhuma pasta for fornecida, o syncord assume que ela é default, onde todos os arquivos são enviados.

🖥️ Dashboard TUI

syncord dashboard

O dashboard fornece:

• Visão geral dos arquivos armazenados.
• Download de pastas e arquivos.
• Uso de armazenamento.
• Navegação interativa.

📊 Estatísticas de Uso

syncord stats

Exibe:

• Total de arquivos enviados
• Total de downloads
• Uso de armazenamento
• Outras métricas rastreadas

🧾 Resumo de Comandos

syncord setup        Mandatory initial configuration
syncord upload       Upload a file or directory
syncord download     Download and reconstruct a file
syncord dashboard    Launch terminal UI dashboard
syncord stats        Show usage statistics

🔐 Modelo de Segurança

• Toda a criptografia acontece localmente.
• O Discord armazena apenas blocos binários criptografados.
• Os metadados são armazenados localmente usando SQLite.
• O Discord nunca vê:
  • Conteúdo dos arquivos.
  • Nomes de arquivo em texto puro.
  • Chaves de criptografia.

O Syncord pressupõe que você confia no seu sistema local; não no Discord.

📁 Estrutura do Projeto

dist/
 ├── syncord.exe          # executable
core/
 ├── db_manager.py        # SQLite metadata handling
 ├── setup.py             # Configuration & setup logic
 ├── partition.py         # File chunking & reconstruction
 ├── tui.py               # Terminal UI dashboard
 ├── encrypter.py         # Encryption & Decryption
 ├── discord_handler.py   # discord bot logic
files/
 ├── uuid/file.bin        # temp storage
main.py                   # CLI entry point

⚠️ Limitações e Notas

• Requer um bot do Discord com as permissões adequadas na guilda. READ_MESSAGE_HISTORY & VIEW_CHANNEL & SEND_MESSAGES & ATTACH_FILES
• Sujeito aos limites de taxa (rate limits) do Discord.
• Não foi feito para substituir serviços públicos de armazenamento em nuvem.
• Projetado para ambientes pessoais ou controlados.

📜 Aviso Legal

Este projeto é destinado a uso educacional e pessoal.
Certifique-se de cumprir os Termos de Serviço do Discord ao usar o Syncord.

🧠 Atualizações Futuras

Problemas que você pode enfrentar e que devem ser corrigidos em breve:

• Limite de taxa (rate limiting) do Discord devido às conexões constantes do bot em uploads múltiplos.
  • Melhor solução: manter a conexão ativa ou fazer upload/download em lote em vez de tratar cada arquivo individualmente; exigiria reescrever um pouco o partition.py.
• Erro inesperado de cliente aiohttp não fechado.