Syncord

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

Syncord è uno strumento CLI di sincronizzazione e archiviazione file che usa Discord come archivio file crittografato.

Consente di caricare file o intere directory su Discord, crittografarli e partizionarli localmente, e in seguito scaricarli e ricostruirli in modo sicuro; il tutto tramite una semplice interfaccia a riga di comando o un'opzionale dashboard TUI.

Syncord è distribuito come eseguibile singolo (syncord.exe) creato con PyInstaller. L'eseguibile può essere inserito direttamente nel PATH di sistema e usato da qualsiasi posizione.

✨ Funzionalità

• 🔐 Crittografia end-to-end

  • I file vengono crittografati localmente prima del caricamento.
  • La chiave di crittografia non viene mai memorizzata su Discord.
  • Senza la chiave, i dati non possono essere recuperati. Assicurati di non cambiarla dopo il caricamento.

• 📦 Partizionamento automatico dei file

  • I file di grandi dimensioni vengono suddivisi in blocchi.
  • I blocchi rispettano i limiti di caricamento di Discord (limiti Discord: 8MB; dimensione blocco: 5MB pre-crittografia; ~7MB post-crittografia)
  • I file vengono riassemblati senza soluzione di continuità durante il download, grazie al tracciamento delle partizioni tramite SQLite.

• 📁 Caricamento di directory

  • Carica intere directory in una volta sola.
  • Scarica anche l'intera directory e le relative sottodirectory.

• 🖥️ Design CLI-first

  • Comandi semplici e scriptabili.
  • Funziona globalmente se aggiunto al PATH

• 🧭 Dashboard TUI

  • Interfaccia terminale interattiva.
  • Visualizza i file memorizzati e le informazioni sull'utilizzo.

• 📊 Statistiche di utilizzo

  • Traccia caricamenti, download e spazio di archiviazione utilizzato.

• 🗄️ Database locale dei metadati

  • Metadati basati su SQLite.
  • Nessuna dipendenza dalla sola cronologia dei messaggi di Discord.

📦 Installazione

Binario precompilato (Consigliato)

1. Scarica syncord.exe
2. Inseriscilo in una directory inclusa nel PATH di sistema
3. Verifica l'installazione:

syncord --help

Syncord può ora essere richiamato da qualsiasi directory.

⚙️ Configurazione iniziale obbligatoria

⚠️ Syncord richiede una configurazione prima del primo utilizzo.

Sia il token del bot Discord che l'ID Guild sono obbligatori.

Configurazione richiesta

• Token del bot Discord.
• ID Guild Discord (il server in cui verranno caricati i file).
• Chiave di crittografia (generata localmente).

Comando di configurazione una tantum

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

Note importanti

• 🔑 La chiave di crittografia è fondamentale.
• ❌ Perdere la chiave significa perdita permanente dei dati.
• 🔒 Discord non può decrittografare o recuperare i tuoi file.
• 🛑 Syncord non funzionerà senza un token e un ID Guild validi.

📤 Caricamento dei file

Carica un singolo file

syncord upload file.ext

Carica un'intera directory

syncord upload nome_cartella

Comportamento:

• Tutti i file all'interno della directory vengono elaborati.
• La struttura delle cartelle viene preservata logicamente.
• Ogni directory diventa un proprio namespace Syncord.

📥 Download dei file

syncord download folder_on_syncord/file

Syncord:

1. Individuerà tutte le partizioni richieste.
2. Le scaricherà da Discord.
3. Le decrittograferà localmente.
4. Riassemblerà il file originale.

NOTA: Se non viene fornita una cartella, syncord presuppone che sia default, dove viene caricato ogni file.

🖥️ Dashboard TUI

syncord dashboard

La dashboard fornisce:

• Panoramica dei file memorizzati.
• Download di cartelle e file.
• Utilizzo dello spazio di archiviazione.
• Navigazione interattiva.

📊 Statistiche di utilizzo

syncord stats

Mostra:

• Totale file caricati
• Totale download
• Utilizzo dello spazio di archiviazione
• Altre metriche tracciate

🧾 Riepilogo dei comandi

syncord setup        Configurazione iniziale obbligatoria
syncord upload       Carica un file o una directory
syncord download     Scarica e ricostruisce un file
syncord dashboard    Avvia la dashboard dell'interfaccia terminale
syncord stats        Mostra le statistiche di utilizzo

🔐 Modello di sicurezza

• Tutta la crittografia avviene localmente.
• Discord memorizza solo blocchi binari crittografati.
• I metadati sono memorizzati localmente tramite SQLite.
• Discord non vede mai:
  • I contenuti dei file.
  • I nomi dei file in chiaro.
  • Le chiavi di crittografia.

Syncord presuppone che tu ti fidi del tuo sistema locale, non di Discord.

📁 Struttura del progetto

dist/
 ├── syncord.exe          # eseguibile
core/
 ├── db_manager.py        # Gestione metadati SQLite
 ├── setup.py             # Logica di configurazione e setup
 ├── partition.py         # Suddivisione e ricostruzione dei file
 ├── tui.py               # Dashboard interfaccia terminale
 ├── encrypter.py         # Crittografia e decrittografia
 ├── discord_handler.py   # Logica del bot Discord
files/
 ├── uuid/file.bin        # Archiviazione temporanea
main.py                   # Punto di ingresso CLI

⚠️ Limiti e note

• Richiede un bot Discord con i permessi appropriati del server. READ_MESSAGE_HISTORY & VIEW_CHANNEL & SEND_MESSAGES & ATTACH_FILES
• Soggetto ai limiti di richiesta (rate limit) di Discord.
• Non è pensato per sostituire un servizio di archiviazione cloud pubblico.
• Progettato per ambienti personali o controllati.

📜 Disclaimer

Questo progetto è inteso per uso didattico e personale.
Assicurati di rispettare i Termini di Servizio di Discord quando utilizzi Syncord.

🧠 Aggiornamenti futuri

Problemi che potresti incontrare e che dovrebbero essere risolti presto:

• Rate limiting da Discord a causa del continuo su e giù del bot nei caricamenti multipli.
  • Soluzione migliore: mantenere la connessione oppure caricare e scaricare in blocco, invece di trattare ogni file singolarmente; richiederebbe una piccola riscrittura di partition.py.
• Errore imprevisto del client aiohttp non chiuso.