DisBucket - Unlimited Storage on Discord Channels

Core Capabilities

Everything you need to turn a standard channel into a powerhouse database.

Smart Chunking

Files are automatically split into 24MB chunks to bypass Discord's file size limits while maintaining file integrity.

Zero-Knowledge Auth

Your data is encrypted locally before upload using AES-256-GCM. Discord servers only see random noise.

Compression

Automatic Gzip compression (Level 9) maximizes your storage efficiency before the encryption step.

Resumable Uploads

Network failure? No problem. The bot tracks chunk status and resumes exactly where it left off.

Local Database

A lightning-fast SQLite layer manages metadata, allowing instant search without API rate limits.

Modern Dashboard

Includes a FastAPI-powered Web UI to manage jobs, view storage stats, and browse your file index.

The Workflow

From local folder to distributed cloud in three steps.

1. Package & Encrypt

The CLI bundles your files into a .tar.gz, encrypts with PBKDF2-derived keys, then splits into upload chunks.

1

> Scanning folder...
> Creating archive.tar.gz...
> Encrypting and splitting...

$ python bot.py upload ./data
[Bot] Creating batch card...
[Bot] Uploading 190 chunks...

2

2. Sync to Discord

The bot posts a metadata "Card", creates a private thread, and uploads chunks concurrently to maximize bandwidth.

3. Restore Anywhere

Download on any machine with the key. Chunks are verified via SHA-256, merged, decrypted, and extracted.

3

> Verifying hashes... OK
> Decrypting archive... OK
> Extracted: ./data

Get Running in 30 Seconds

1 Clone & Install

git clone https://github.com/Mo-Shakib/discord-object-store.git
cd discord-object-store
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2 Configure

python setup.py

Follow the wizard to set your Discord Token and encryption key.

3 Launch UI

uvicorn src.api:app --reload

Open http://localhost:8000 after the server starts.

CLI Reference

Command	Action
upload <path>	Packages, encrypts, and uploads target to Discord.
download <id>	Fetches and reconstructs a batch by ID.
resume <id>	Continues an interrupted upload from the last chunk.
list	Displays all indexed batches from local SQLite.
stats	Storage metrics, cache size, and API latency.

Change Log

v4.0.0 Latest

Discord-style Web UI with live jobs, uploads, and batch management.

v4 Highlights

Web UI: New dashboard with live job runner, stats, and uploads.
Batch Explorer: Searchable table with hover actions and metadata.
System Actions: One-click sync, backup, and reset workflows.

v3.0.0

New storage workflow with CLI commands, SQLite metadata, and faster sync.

v3 Highlights

CLI Workflow: Upload, download, list, info, stats, verify, resume.
SQLite Metadata: WAL mode, indexes, and fast local search.
Discord Layout: Threaded storage channel + batch index cards.

Note: Keep your encryption key secure. Without it, batches cannot be decrypted.

v2.0.0

Major security overhaul and architecture improvements.

New Security Model

Encryption: AES-256-GCM per chunk.
Key Derivation: PBKDF2-HMAC-SHA256 with 600,000 iterations.

v1.0.0

Initial release with basic chunking, upload/download commands, and archive cards.