Syncord

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

Syncord ist ein CLI-basiertes Dateisynchronisations- und Speichertool, das Discord als verschlüsselten Dateispeicher nutzt.

Es ermöglicht das Hochladen von Dateien oder gesamten Ordnern auf Discord, die lokale Verschlüsselung und Partitionierung sowie das spätere sichere Herunterladen und Wiederherstellen – alles über eine einfache Kommandozeile oder ein optionales TUI-Dashboard.

Syncord wird als einzelne ausführbare Datei (syncord.exe) verteilt, die mit PyInstaller erstellt wurde. Die ausführbare Datei kann direkt in Ihren System-PATH gelegt und von überall verwendet werden.

✨ Funktionen

• 🔐 Ende-zu-Ende-Verschlüsselung

  • Dateien werden vor dem Hochladen lokal verschlüsselt.
  • Der Verschlüsselungsschlüssel wird nie auf Discord gespeichert.
  • Ohne den Schlüssel können Daten nicht wiederhergestellt werden. Ändern Sie ihn nach dem Hochladen nicht.

• 📦 Automatische Dateiaufteilung

  • Große Dateien werden in Teile aufgeteilt.
  • Die Teile entsprechen den Discord-Upload-Limits (Discord-Limit: 8 MB; Teilgröße: 5 MB vor Verschlüsselung; ~7 MB nach Verschlüsselung)
  • Dateien werden beim Herunterladen nahtlos wieder zusammengesetzt. Dank SQLite, das die Partitionen verfolgt.

• 📁 Ordner hochladen

  • Ganze Ordner auf einmal hochladen.
  • Auch den gesamten Ordner und Unterordner herunterladen.

• 🖥️ CLI-zentriertes Design

  • Einfache, skriptbare Befehle.
  • Funktioniert global, wenn es zum PATH hinzugefügt wird.

• 🧭 TUI-Dashboard

  • Interaktive Terminal-Oberfläche.
  • Gespeicherte Dateien und Nutzungsinformationen anzeigen.

• 📊 Nutzungsstatistiken

  • Verfolgen Sie Uploads, Downloads und Speichernutzung.

• 🗄️ Lokale Metadaten-Datenbank

  • Metadaten basierend auf SQLite.
  • Keine alleinige Abhängigkeit vom Discord-Nachrichtenverlauf.

📦 Installation

Vorgefertigte Binärdatei (Empfohlen)

1. Laden Sie syncord.exe herunter
2. Legen Sie es in einem Verzeichnis ab, das in Ihrem System-PATH enthalten ist
3. Überprüfen Sie die Installation:

syncord --help

Syncord kann nun von jedem Verzeichnis aus aufgerufen werden.

⚙️ Erforderliche Ersteinrichtung

⚠️ Syncord erfordert eine Einrichtung vor der ersten Nutzung.

Sowohl der Discord-Bot-Token als auch die Guild-ID sind erforderlich.

Erforderliche Konfiguration

• Discord-Bot-Token.
• Discord-Guild-ID (Server, auf den Dateien hochgeladen werden).
• Verschlüsselungsschlüssel (lokal generiert).

Einmaliger Einrichtungsbefehl

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

Wichtige Hinweise

• 🔑 Der Verschlüsselungsschlüssel ist entscheidend.
• ❌ Der Verlust des Schlüssels bedeutet dauerhaften Datenverlust.
• 🔒 Discord kann Ihre Dateien weder entschlüsseln noch wiederherstellen.
• 🛑 Syncord funktioniert nicht ohne gültigen Token und Guild-ID.

📤 Dateien hochladen

Eine einzelne Datei hochladen

syncord upload file.ext

Einen gesamten Ordner hochladen

syncord upload folder_name

Verhalten:

• Alle Dateien im Ordner werden verarbeitet.
• Die Ordnerstruktur wird logisch beibehalten.
• Jeder Ordner wird zu einem eigenen Syncord-Ordner-Namensraum.

📥 Dateien herunterladen

syncord download folder_on_syncord/file

Syncord wird:

1. Alle erforderlichen Partitionen finden.
2. Diese von Discord herunterladen.
3. Lokal entschlüsseln.
4. Die Originaldatei wieder zusammensetzen.

HINWEIS: Wenn kein Ordner angegeben wird, nimmt Syncord an, dass es sich um default handelt, wohin jede Datei hochgeladen wird.

🖥️ TUI-Dashboard

syncord dashboard

Das Dashboard bietet:

• Übersicht der gespeicherten Dateien.
• Ordner und Dateien herunterladen.
• Speichernutzung.
• Interaktive Navigation.

📊 Nutzungsstatistiken

syncord stats

Zeigt an:

• Insgesamt hochgeladene Dateien
• Insgesamt heruntergeladene Dateien
• Speichernutzung
• Andere verfolgte Metriken

🧾 Befehlsübersicht

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

🔐 Sicherheitsmodell

• Die gesamte Verschlüsselung erfolgt lokal.
• Discord speichert nur verschlüsselte Binärteile.
• Metadaten werden lokal mit SQLite gespeichert.
• Discord sieht nie:
  • Dateiinhalte.
  • Klartext-Dateinamen.
  • Verschlüsselungsschlüssel.

Syncord geht davon aus, dass Sie Ihrem lokalen System vertrauen, nicht Discord.

📁 Projektstruktur

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

⚠️ Einschränkungen und Hinweise

• Erfordert einen Discord-Bot mit entsprechenden Guild-Berechtigungen: READ_MESSAGE_HISTORY, VIEW_CHANNEL, SEND_MESSAGES, ATTACH_FILES
• Unterliegt den Discord-Ratenbegrenzungen.
• Nicht als Ersatz für öffentliche Cloud-Speicher gedacht.
• Für persönliche oder kontrollierte Umgebungen konzipiert.

📜 Haftungsausschluss

Dieses Projekt ist für Bildungs- und Privatzwecke bestimmt.
Stellen Sie sicher, dass bei der Nutzung von Syncord die Discord-Nutzungsbedingungen eingehalten werden.

🧠 Zukünftige Updates

Problem, auf das Sie stoßen könnten und das bald behoben werden sollte:

• Ratenbegrenzung durch Discord aufgrund des ständigen Ein- und Ausschaltens des Bots bei mehreren Uploads.
  • Beste Lösung: Verbindung aufrechterhalten oder Bulk-Upload und -Download gemeinsam durchführen, anstatt jede Datei einzeln zu behandeln; würde eine kleine Umschreibung von partition.py erfordern.
• unerwarteter Fehler eines nicht geschlossenen aiohttp-Clients.