Syncord

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

Syncord は、Discord を 暗号化ファイルストレージ として利用する、CLI ベースのファイル同期・保存ツールです。

ファイルやディレクトリ全体を Discord にアップロードし、ローカルで暗号化・分割し、後で安全にダウンロード・復元することができます。すべてシンプルなコマンドラインインターフェース、またはオプションの TUI ダッシュボードを通じて操作可能です。

Syncord は 単一の実行ファイル (syncord.exe) として配布され、PyInstaller でビルドされています。実行ファイルはシステムの PATH に直接配置し、どこからでも使用できます。

✨ 特徴

• 🔐 エンドツーエンド暗号化

  • ファイルはアップロード前にローカルで暗号化されます。
  • 暗号鍵は Discord に保存されることはありません。
  • 鍵がないとデータを復元できません。アップロード後に鍵を変更しないように注意してください。

• 📦 自動ファイル分割

  • 大きなファイルはチャンクに分割されます。
  • チャンクは Discord のアップロード制限に準拠します（Discord 制限: 8MB、チャンクサイズ: 暗号化前 5MB、暗号化後約 7MB）。
  • ダウンロード時にはファイルがシームレスに再構築されます。SQLite によるパーティション追跡のおかげです。

• 📁 ディレクトリアップロード

  • ディレクトリ全体を一度にアップロード。
  • ディレクトリとサブディレクトリ全体もダウンロード可能。

• 🖥️ CLI ファースト設計

  • シンプルでスクリプト可能なコマンド。
  • PATH に追加すればグローバルに動作。

• 🧭 TUI ダッシュボード

  • インタラクティブなターミナルインターフェース。
  • 保存されたファイルと使用状況を表示。

• 📊 使用統計

  • アップロード数、ダウンロード数、ストレージ使用量を追跡。

• 🗄️ ローカルメタデータデータベース

  • SQLite バックエンドのメタデータ。
  • Discord のメッセージ履歴のみに依存しません。

📦 インストール

ビルド済みバイナリ（推奨）

1. syncord.exe をダウンロード
2. システムの PATH に含まれるディレクトリに配置
3. インストールを確認:

syncord --help

これで Syncord を 任意のディレクトリ から呼び出せるようになります。

⚙️ 必須の初期設定

⚠️ Syncord は初回使用前に設定が必要です。

Discord ボットトークン と ギルド ID は両方とも必須です。

必要な設定項目

• Discord ボットトークン
• Discord ギルド ID（ファイルをアップロードするサーバー）
• 暗号鍵（ローカルで生成）

一度だけ行う設定コマンド

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

重要な注意事項

• 🔑 暗号鍵は非常に重要です。
• ❌ 鍵を失うと データは永久に失われます。
• 🔒 Discord はファイルを復号したり復元したりできません。
• 🛑 有効なトークンとギルド ID がない場合、Syncord は機能しません。

📤 ファイルのアップロード

単一ファイルをアップロード

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    ターミナル UI ダッシュボードを起動
syncord stats        使用統計を表示

🔐 セキュリティモデル

• すべての暗号化は ローカル で行われます。
• Discord は暗号化されたバイナリチャンクのみを保存します。
• メタデータは SQLite を使用してローカルに保存されます。
• Discord が知ることはありません:
  • ファイルの内容
  • 平文のファイル名
  • 暗号鍵

Syncord は、ローカルシステムを信頼し、Discord は信頼しないことを前提としています。

📁 プロジェクト構造

dist/
 ├── syncord.exe          # 実行ファイル
core/
 ├── db_manager.py        # SQLite メタデータ処理
 ├── setup.py             # 設定・セットアップロジック
 ├── partition.py         # ファイル分割・再構築
 ├── tui.py               # ターミナル UI ダッシュボード
 ├── encrypter.py         # 暗号化・復号
 ├── discord_handler.py   # Discord ボットロジック
files/
 ├── uuid/file.bin        # 一時保存
main.py                   # CLI エントリポイント

⚠️ 制限と注意事項

• 適切なギルド権限を持つ Discord ボットが必要です。READ_MESSAGE_HISTORY、VIEW_CHANNEL、SEND_MESSAGES、ATTACH_FILES
• Discord のレート制限の対象となります。
• 公開クラウドストレージの代替として意図されたものではありません。
• 個人使用または管理された環境向けに設計されています。

📜 免責事項

このプロジェクトは 教育目的および個人使用 を目的としています。
Syncord を使用する際は、Discord の利用規約に準拠してください。

🧠 今後のアップデート

発生する可能性があり、近日中に修正されるべき問題:

• ボットの複数アップロード時の継続的な起動・停止による Discord のレート制限。
  • 最善の解決策: 接続を維持するか、各ファイルを個別に処理する代わりに一括でアップロード・ダウンロードを行う。partition.py を少し書き直す必要があります。
• 未クローズの aiohttp クライアントによる予期しないエラー。