Syncord

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

Syncord — это инструмент синхронизации и хранения файлов на основе CLI, использующий Discord в качестве зашифрованного файлового хранилища.

Он позволяет загружать файлы или целые каталоги в Discord, шифровать и разбивать их на части локально, а затем безопасно скачивать и восстанавливать — всё через простой интерфейс командной строки или опциональную TUI-панель.

Syncord распространяется как одиночный исполняемый файл (syncord.exe), собранный с помощью PyInstaller. Исполняемый файл можно разместить непосредственно в системном PATH и использовать откуда угодно.

✨ Возможности

• 🔐 Сквозное шифрование

  • Файлы шифруются локально перед загрузкой.
  • Ключ шифрования никогда не хранится на Discord.
  • Без ключа данные восстановить невозможно. Убедитесь, что вы не меняете его после загрузки.

• 📦 Автоматическое разбиение файлов

  • Большие файлы разбиваются на части.
  • Части соответствуют лимитам загрузки Discord (лимит Discord: 8MB; размер части: 5MB до шифрования; ~7MB после шифрования).
  • Файлы бесшовно собираются обратно при скачивании. Благодаря отслеживанию частей через SQLite.

• 📁 Загрузка каталогов

  • Загружайте сразу целые каталоги.
  • Скачивайте весь каталог и подкаталоги тоже.

• 🖥️ CLI-first дизайн

  • Простые команды, пригодные для скриптов.
  • Работает глобально при добавлении в PATH

• 🧭 TUI-панель

  • Интерактивный терминальный интерфейс.
  • Просмотр хранящихся файлов и информации об использовании.

• 📊 Статистика использования

  • Отслеживание загрузок, скачиваний и объёма хранилища.

• 🗄️ Локальная база метаданных

  • Метаданные на основе SQLite.
  • Отсутствие зависимости только от истории сообщений Discord.

📦 Установка

Готовый бинарный файл (рекомендуется)

1. Скачайте syncord.exe
2. Поместите его в каталог, включённый в системный PATH
3. Проверьте установку:

syncord --help

Теперь Syncord можно вызывать из любого каталога.

⚙️ Обязательная первоначальная настройка

⚠️ Syncord требует настройки перед первым использованием.

Обязательны как токен бота Discord, так и ID гильдии.

Требуемая конфигурация

• Токен бота Discord.
• ID гильдии Discord (сервер, на который будут загружаться файлы).
• Ключ шифрования (генерируется локально).

Команда одноразовой настройки

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

Важные замечания

• 🔑 Ключ шифрования критически важен.
• ❌ Потеря ключа означает полную потерю данных.
• 🔒 Discord не может расшифровать или восстановить ваши файлы.
• 🛑 Syncord не будет работать без действительного токена и ID гильдии.

📤 Загрузка файлов

Загрузка одного файла

syncord upload file.ext

Загрузка целого каталога

syncord upload folder_name

Поведение:

• Обрабатываются все файлы внутри каталога.
• Структура папок логически сохраняется.
• Каждый каталог становится собственным пространством имён папок Syncord.

📥 Скачивание файлов

syncord download folder_on_syncord/file

Syncord:

1. Найдёт все требуемые части.
2. Скачает их с Discord.
3. Расшифрует локально.
4. Восстановит исходный файл.

ПРИМЕЧАНИЕ: Если папка не указана, syncord считает её default, куда загружается каждый файл.

🖥️ TUI-панель

syncord dashboard

Панель предоставляет:

• Обзор хранящихся файлов.
• Скачивание папок и файлов.
• Использование хранилища.
• Интерактивную навигацию.

📊 Статистика использования

syncord stats

Отображает:

• Всего загружено файлов
• Всего скачиваний
• Использование хранилища
• Другие отслеживаемые метрики

🧾 Сводка команд

syncord setup        Обязательная начальная настройка
syncord upload       Загрузка файла или каталога
syncord download     Скачивание и восстановление файла
syncord dashboard    Запуск терминальной TUI-панели
syncord stats        Показ статистики использования

🔐 Модель безопасности

• Всё шифрование происходит локально.
• Discord хранит только зашифрованные бинарные части.
• Метаданные хранятся локально с помощью SQLite.
• Discord никогда не видит:
  • Содержимое файлов.
  • Имена файлов в открытом виде.
  • Ключи шифрования.

Syncord предполагает, что вы доверяете своей локальной системе, а не Discord.

📁 Структура проекта

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

⚠️ Ограничения и замечания

• Требуется бот Discord с соответствующими правами на сервере. READ_MESSAGE_HISTORY & VIEW_CHANNEL & SEND_MESSAGES & ATTACH_FILES
• Действуют лимиты скорости Discord.
• Не предназначен как замена публичному облачному хранилищу.
• Разработан для личного использования или контролируемых сред.

📜 Отказ от ответственности

Этот проект предназначен для образовательного и личного использования.
При использовании Syncord соблюдайте Условия предоставления услуг Discord.

🧠 Будущие обновления

Проблемы, с которыми вы можете столкнуться и которые должны быть исправлены в ближайшее время:

• Ограничение скорости со стороны Discord из-за постоянного подключения и отключения бота при массовой загрузке.
  • Лучшее решение: поддерживать соединение или загружать/скачивать всё пакетно, а не обрабатывать каждый файл по отдельности; потребует небольшой переработки partition.py.
• Неожиданная ошибка незакрытого клиента aiohttp.