Syncord

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

Syncord est un outil de synchronisation et de stockage de fichiers en ligne de commande qui utilise Discord comme stockage de fichiers chiffrés.

Il permet de téléverser des fichiers ou des répertoires entiers vers Discord, de les chiffrer et de les partitionner localement, puis de les télécharger et de les reconstruire en toute sécurité ; le tout via une interface en ligne de commande simple ou un tableau de bord TUI optionnel.

Syncord est distribué sous forme d'exécutable unique (syncord.exe) compilé avec PyInstaller. L'exécutable peut être placé directement dans votre PATH système et utilisé depuis n'importe où.

✨ Fonctionnalités

• 🔐 Chiffrement de bout en bout

  • Les fichiers sont chiffrés localement avant le téléversement.
  • La clé de chiffrement n'est jamais stockée sur Discord.
  • Sans la clé, les données ne peuvent pas être récupérées. Assurez-vous de ne pas la modifier après le téléversement.

• 📦 Partitionnement automatique des fichiers

  • Les gros fichiers sont divisés en morceaux.
  • Les morceaux respectent les limites de téléversement de Discord (limites Discord : 8 Mo ; taille des morceaux : 5 Mo avant chiffrement ; ~7 Mo après chiffrement).
  • Les fichiers sont réassemblés sans couture lors du téléchargement, grâce au suivi des partitions via SQLite.

• 📁 Téléversement de répertoires

  • Téléversez des répertoires entiers en une seule fois.
  • Téléchargez également le répertoire complet et ses sous‑répertoires.

• 🖥️ Conception axée CLI

  • Commandes simples et scriptables.
  • Fonctionne globalement une fois ajouté au PATH.

• 🧭 Tableau de bord TUI

  • Interface terminal interactive.
  • Consultez les fichiers stockés et les informations d'utilisation.

• 📊 Statistiques d'utilisation

  • Suivi des téléversements, téléchargements et de l'espace de stockage utilisé.

• 🗄️ Base de données de métadonnées locale

  • Métadonnées stockées dans SQLite.
  • Aucune dépendance exclusive à l'historique des messages Discord.

📦 Installation

Binaire précompilé (Recommandé)

1. Téléchargez syncord.exe
2. Placez-le dans un répertoire inclus dans votre PATH système.
3. Vérifiez l'installation :

syncord --help

Syncord peut désormais être invoqué depuis n'importe quel répertoire.

⚙️ Configuration initiale obligatoire

⚠️ Syncord nécessite une configuration avant la première utilisation.

Le token du bot Discord et l'ID du serveur (Guild ID) sont obligatoires.

Configuration requise

• Token du bot Discord.
• ID du serveur Discord (guild) où les fichiers seront téléversés.
• Clé de chiffrement (générée localement).

Commande de configuration unique

syncord setup --token VOTRE_TOKEN_DISCORD --guild-id VOTRE_ID_SERVEUR --encryption-key

Remarques importantes

• 🔑 La clé de chiffrement est cruciale.
• ❌ Perdre la clé signifie perte définitive des données.
• 🔒 Discord ne peut ni déchiffrer ni récupérer vos fichiers.
• 🛑 Syncord ne fonctionnera pas sans un token et un ID de serveur valides.

📤 Téléversement de fichiers

Téléverser un seul fichier

syncord upload fichier.ext

Téléverser un répertoire entier

syncord upload nom_dossier

Comportement :

• Tous les fichiers du répertoire sont traités.
• La structure des dossiers est logiquement préservée.
• Chaque répertoire devient son propre espace de noms Syncord.

📥 Téléchargement de fichiers

syncord download dossier_sur_syncord/fichier

Syncord va :

1. Localiser toutes les partitions nécessaires.
2. Les télécharger depuis Discord.
3. Les déchiffrer localement.
4. Réassembler le fichier d'origine.

NOTE : Si aucun dossier n'est fourni, syncord considère qu'il s'agit du dossier default où chaque fichier est téléversé.

🖥️ Tableau de bord TUI

syncord dashboard

Le tableau de bord fournit :

• Aperçu des fichiers stockés.
• Téléchargement de dossiers et fichiers.
• Utilisation du stockage.
• Navigation interactive.

📊 Statistiques d'utilisation

syncord stats

Affiche :

• Nombre total de fichiers téléversés
• Nombre total de téléchargements
• Espace de stockage utilisé
• Autres métriques suivies

🧾 Résumé des commandes

syncord setup        Configuration initiale obligatoire
syncord upload       Téléverser un fichier ou un répertoire
syncord download     Télécharger et reconstruire un fichier
syncord dashboard    Lancer l'interface TUI
syncord stats        Afficher les statistiques d'utilisation

🔐 Modèle de sécurité

• Tout le chiffrement s'effectue localement.
• Discord ne stocke que des fragments binaires chiffrés.
• Les métadonnées sont stockées localement via SQLite.
• Discord ne voit jamais :
  • Le contenu des fichiers.
  • Les noms de fichiers en clair.
  • Les clés de chiffrement.

Syncord suppose que vous faites confiance à votre système local, pas à Discord.

📁 Structure du projet

dist/
 ├── syncord.exe          # exécutable
core/
 ├── db_manager.py        # Gestion des métadonnées SQLite
 ├── setup.py             # Logique de configuration
 ├── partition.py         # Découpage et reconstruction des fichiers
 ├── tui.py               # Tableau de bord TUI
 ├── encrypter.py         # Chiffrement et déchiffrement
 ├── discord_handler.py   # Logique du bot Discord
files/
 ├── uuid/file.bin        # Stockage temporaire
main.py                   # Point d'entrée CLI

⚠️ Limitations et remarques

• Nécessite un bot Discord avec les permissions appropriées sur le serveur : READ_MESSAGE_HISTORY, VIEW_CHANNEL, SEND_MESSAGES, ATTACH_FILES.
• Soumis aux limites de taux de Discord (rate limits).
• N'est pas conçu pour remplacer un stockage cloud public.
• Conçu pour un usage personnel ou dans un environnement contrôlé.

📜 Avertissement

Ce projet est destiné à un usage éducatif et personnel.
Assurez-vous de respecter les conditions d'utilisation de Discord lorsque vous utilisez Syncord.

🧠 Mises à jour futures

Problèmes que vous pourriez rencontrer et qui devraient être corrigés prochainement :

• Limitation de débit de Discord due aux connexions/déconnexions constantes du bot lors de téléversements multiples.
  • Meilleure solution : maintenir la connexion ou effectuer des téléversements/téléchargements groupés au lieu de traiter chaque fichier individuellement ; nécessiterait une légère réécriture de partition.py.
• Erreur inattendue de client aiohttp non fermé.