Syncord

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

Syncord es una herramienta de sincronización y almacenamiento de archivos basada en CLI que utiliza Discord como almacenamiento de archivos cifrado.

Permite subir archivos o directorios completos a Discord, cifrarlos y particionarlos localmente, y luego descargarlos y reconstruirlos de forma segura; todo a través de una interfaz de línea de comandos simple o un panel TUI opcional.

Syncord se distribuye como un ejecutable único (syncord.exe) compilado con PyInstaller. El ejecutable se puede colocar directamente en el PATH del sistema y usarse desde cualquier lugar.

✨ Características

• 🔐 Cifrado de extremo a extremo

  • Los archivos se cifran localmente antes de subirlos.
  • La clave de cifrado nunca se almacena en Discord.
  • Sin la clave, los datos no se pueden recuperar. Asegúrate de no cambiarla después de subir el archivo.

• 📦 Particionado automático de archivos

  • Los archivos grandes se dividen en fragmentos.
  • Los fragmentos cumplen con los límites de carga de Discord (límites de Discord: 8 MB; tamaño de fragmento: 5 MB antes del cifrado; ~7 MB después del cifrado)
  • Los archivos se vuelven a ensamblar sin problemas al descargarlos. Gracias al seguimiento de particiones mediante SQLite.

• 📁 Carga de directorios

  • Sube directorios completos de una sola vez.
  • También descarga el directorio completo y sus subdirectorios.

• 🖥️ Diseño priorizando la CLI

  • Comandos simples y aptos para scripts.
  • Funciona globalmente cuando se añade al PATH

• 🧭 Panel TUI

  • Interfaz de terminal interactiva.
  • Consulta archivos almacenados e información de uso.

• 📊 Estadísticas de uso

  • Realiza un seguimiento de cargas, descargas y almacenamiento utilizado.

• 🗄️ Base de datos local de metadatos

  • Metadatos respaldados por SQLite.
  • Sin dependencia únicamente del historial de mensajes de Discord.

📦 Instalación

Binario precompilado (Recomendado)

1. Descarga syncord.exe
2. Colócalo en un directorio incluido en el PATH del sistema
3. Verifica la instalación:

syncord --help

Ahora se puede invocar a Syncord desde cualquier directorio.

⚙️ Configuración inicial obligatoria

⚠️ Syncord requiere configuración antes del primer uso.

Tanto el token del bot de Discord como el ID de Guild son obligatorios.

Configuración requerida

• Token del bot de Discord.
• ID de servidor de Discord (servidor donde se subirán los archivos).
• Clave de cifrado (generada localmente).

Comando de configuración único

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

Notas importantes

• 🔑 La clave de cifrado es crítica.
• ❌ Perder la clave significa pérdida permanente de datos.
• 🔒 Discord no puede descifrar ni recuperar tus archivos.
• 🛑 Syncord no funcionará sin un token y un ID de servidor válidos.

📤 Subir archivos

Subir un solo archivo

syncord upload file.ext

Subir un directorio completo

syncord upload folder_name

Comportamiento:

• Todos los archivos dentro del directorio se procesan.
• La estructura de carpetas se conserva lógicamente.
• Cada directorio se convierte en su propio espacio de nombres de carpeta de Syncord.

📥 Descargar archivos

syncord download folder_on_syncord/file

Syncord hará lo siguiente:

1. Localizar todas las particiones requeridas.
2. Descargarlas desde Discord.
3. Descifrarlas localmente.
4. Reensamblar el archivo original.

NOTA: Si no se proporciona una carpeta, syncord asume que es default, donde se sube cada archivo.

🖥️ Panel TUI

syncord dashboard

El panel proporciona:

• Descripción general de los archivos almacenados.
• Descarga de carpetas y archivos.
• Uso de almacenamiento.
• Navegación interactiva.

📊 Estadísticas de uso

syncord stats

Muestra:

• Total de archivos subidos
• Total de descargas
• Uso de almacenamiento
• Otras métricas registradas

🧾 Resumen de comandos

syncord setup        Configuración inicial obligatoria
syncord upload       Sube un archivo o directorio
syncord download     Descarga y reconstruye un archivo
syncord dashboard    Inicia el panel TUI de terminal
syncord stats        Muestra estadísticas de uso

🔐 Modelo de seguridad

• Todo el cifrado ocurre localmente.
• Discord solo almacena fragmentos binarios cifrados.
• Los metadatos se almacenan localmente usando SQLite.
• Discord nunca ve:
  • Contenido de archivos.
  • Nombres de archivo en texto plano.
  • Claves de cifrado.

Syncord asume que confías en tu sistema local; no en Discord.

📁 Estructura del proyecto

dist/
 ├── syncord.exe          # ejecutable
core/
 ├── db_manager.py        # Manejo de metadatos SQLite
 ├── setup.py             # Lógica de configuración y ajustes
 ├── partition.py         # Fragmentación y reconstrucción de archivos
 ├── tui.py               # Panel TUI de terminal
 ├── encrypter.py         # Cifrado y descifrado
 ├── discord_handler.py   # Lógica del bot de Discord
files/
 ├── uuid/file.bin        # almacenamiento temporal
main.py                   # Punto de entrada CLI

⚠️ Limitaciones y notas

• Requiere un bot de Discord con los permisos adecuados del servidor: READ_MESSAGE_HISTORY, VIEW_CHANNEL, SEND_MESSAGES y ATTACH_FILES.
• Sujeto a los límites de tasa de Discord.
• No está pensado como reemplazo del almacenamiento en la nube público.
• Diseñado para entornos personales o controlados.

📜 Descargo de responsabilidad

Este proyecto está destinado a uso educativo y personal.
Asegúrate de cumplir con los Términos de Servicio de Discord al usar Syncord.

🧠 Próximas actualizaciones

Problema que podrías enfrentar y que debería solucionarse pronto:

• Límites de tasa de Discord debido a la subida y bajada constante del bot en cargas múltiples.
  • Mejor solución: mantener la conexión o subir y descargar en lote en lugar de tratar cada archivo individualmente; requeriría reescribir un poco partition.py.
• Error inesperado de cliente aiohttp sin cerrar.