Skip to content
This repository was archived by the owner on May 22, 2025. It is now read-only.
/ ShadowBox Public archive

local based encrypted storage platform. No surveillance, no leaks- just pure privacy

Notifications You must be signed in to change notification settings

dillionhuston/ShadowBox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ShadowBox 📦

Secure & Private Cloud Storage - Your Digital Fort Knox

GitHub stars GitHub forks GitHub issues License

Your files, your control, your privacy.


🚀 Overview

⚠️ Prototype Warning: ShadowBox is in early development. Avoid using it for sensitive or production data.

ShadowBox is a privacy-first, encrypted cloud storage solution built with Python, Flask, and SQL. Designed for security and scalability, it leverages object-oriented programming principles to ensure maintainability. Our vision is a decentralized, secure file-sharing platform that puts user control first.


🎯 Core Features (MVP)

  • 🔒 AES-256 Encrypted File Uploads
  • 🧑‍💻 User Authentication & File Ownership
  • 📂 Secure File Storage & Retrieval
  • Expiring Links & Access Controls
  • 🛠️ Modular OOP Architecture

🔐 Security Implementation

Encryption

  • AES-256 GCM Mode provides:
    • Confidentiality
    • Authentication (tamper detection)
    • Built-in integrity checking

Key Derivation

  • PBKDF2 with SHA-256
  • 100,000 iterations
  • 16-byte salt, 32-byte key

File Storage

  • Sanitized file names
  • Files saved with .enc extension
  • Physical paths hidden from users

🛠️ Tech Stack

Component Technology
Backend Python (Flask), OOP Design
Frontend Jinja2, HTML, CSS, JS
Database SQLite (PostgreSQL planned)
Encryption AES-256, RSA (planned)

⚙️ Installation

Run ShadowBox locally with Python:

# Clone the repository
git clone https://github.com/dillionhuston/shadowbox.git
cd shadowbox

# Create and activate a virtual environment (optional but recommended)
python3 -m venv venv
source venv/bin/activate  # or venv\Scripts\activate on Windows

# Install dependencies
pip install -r requirements.txt

# Set Flask environment variables (if needed)
export FLASK_APP=app.py  

# Launch the app
flask run

About

local based encrypted storage platform. No surveillance, no leaks- just pure privacy

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published