LazyOwnInfiniteStorage

Production-grade tool for encoding any file into a video and decoding it back with full data recovery, even after video resolution changes.

Inspired by the concept of DvorakDwarf's Infinite-Storage-Glitch, this implementation provides a hardened, tested, and self-contained Python utility with CLI, optional GUI, and optional web interfaces.

Architecture

The project follows a strict single-file-per-contract pattern:

• lazyown_infinitestorage.py -- Core library, CLI runner, WebRunner, GUIRunner (self-contained)
• wsgi_app.py -- WSGI entry point for gunicorn and production web servers
• tests/ -- Comprehensive BDD/TDD pytest suite
• templates/index.html -- Web interface template
• static/css/ -- Theme stylesheets
• render.yaml -- Render.com deployment configuration

Features

• Dual protocol support:
  • Legacy v1: end-of-file marker with filename-based resolution recovery
  • Secure v2: structured binary header with CRC32 integrity checks and Hamming(8,4) single-bit error correction
• Encode any file into a video using configurable pixel blocks
• Decode files from videos even after resolution changes
• Vectorized NumPy frame processing for performance
• Direct FFmpeg stdin/stdout piping without intermediate frame files
• Centralized configuration via LazyOwnConfig
• Security-hardened input validation and path sanitization
• Flask web server with security headers, CSRF protection, file extension validation, and size limits
• PyQt5 graphical user interface with background worker threads

Requirements

• Python 3.8+
• FFmpeg
• NumPy
• OpenCV (opencv-python or opencv-python-headless)
• Flask (optional, for web interface)
• PyQt5 (optional, for GUI)
• gunicorn (optional, for production web server)

Install core dependencies:

pip install numpy opencv-python-headless

Install optional dependencies:

pip install flask werkzeug pyqt5 gunicorn

Usage

Command Line

Encode a file using the secure protocol:

python lazyown_infinitestorage.py --mode encode --input file.zip --output video.mp4 --frame_size 640 480 --fps 30 --block_size 4 --protocol secure

Decode a file from a video:

python lazyown_infinitestorage.py --mode decode --input video_640x480.mp4 --output recovered.zip --block_size 4 --protocol secure

Run the built-in test suite:

python lazyown_infinitestorage.py --mode test

Launch the GUI (does not require --mode):

python lazyown_infinitestorage.py --gui

Launch the web server (does not require --mode):

python lazyown_infinitestorage.py --serve --host 0.0.0.0 --port 5000

Web Server (Production)

For production deployment with gunicorn:

gunicorn wsgi_app:app

Protocols

Legacy v1

• Uses an end-of-file marker (0x80) to determine payload boundaries
• Stores the original frame resolution in the output filename
• Compatible with the original Infinite-Storage-Glitch workflow

Secure v2

• Binary header (LAZY magic, version, original file size, width, height, block size, FPS)
• Header and payload protected by CRC32 checksums
• Full payload protected by Hamming(8,4) extended error correction, capable of correcting single-bit errors per byte
• Resolution is recovered from the filename or video metadata

Security

• Path traversal prevention on all file operations via SecurityValidator
• Filename sanitization using an allowlist regex ([^a-zA-Z0-9_\-\.])
• Maximum file size limits enforced at config, validator, and web layers
• Web mode includes security headers (HSTS, X-Frame-Options, X-Content-Type-Options, XSS protection)
• MAX_CONTENT_LENGTH enforced on web uploads
• File extension validation on encode and decode operations
• Upload directory isolation with tempfile-based processing

Testing

Run the full test suite with pytest:

pytest tests/ -v

The test suite covers:

• Configuration validation
• Security validator (path traversal, sanitization, size limits, extension checks)
• Hamming(8,4) error correction (encode/decode, single-bit error correction)
• Frame encoding and decoding
• Protocol handlers (Legacy and Secure)
• Full encode/decode roundtrip including resize scenarios
• Flask web interface routes, uploads, downloads, and security headers

Deployment

The project includes a render.yaml for Render.com deployment:

services:
  - type: web
    name: lazyowninfinitestorage
    env: python
    plan: free
    buildCommand: "pip install -r requirements.txt"
    startCommand: "gunicorn wsgi_app:app"

License

GNU General Public License v3.0

Acknowledgments

Inspired by DvorakDwarf's Infinite-Storage-Glitch concept. Credited in the code and documentation as the original idea source.

Contributing

See CONTRIBUTING.md for guidelines.

Knowledge Base

This project has been analyzed by ReadMenator, a zero-token polyglot static analysis tool. Regenerate with pip install readmenator && readmenator . --rebuild. Analysis outputs:

• KNOWLEDGE_BASE.md -- Full architecture reference with all classes, functions, imports, dependency graphs, UML class diagrams, security audit findings, community analysis, taint paths, hotspots, cycles, and more.
• readmenator-agent/ -- Agent-friendly, grep-optimized index.
  • INDEX.md -- Quick reference: what each file does
  • SYMBOLS.md -- Every symbol with file:line
  • ARCHITECTURE.md -- Internal dependency pairs + external imports
  • API.md -- Public function contracts
  • GOTCHAS.md -- Change warnings (blast radius, cycles, hotspots)
  • SECURITY.md -- Findings by severity with fix hints
  • MEMORY.md -- Rules, workflow, style, deliverables, session log
  • MANIFEST.json -- Freshness (git_commit + source_fingerprint) + read order
  • KB_<subsystem>.md -- Per-subsystem context
  • recipes/*.md -- Grounded task guides (add-function, fix-cycle, ...)
• readmenator-wiki/ -- Navigable wiki (start here for the big picture).
  • index.md -- Entry point: overview, reading order, god nodes, connections
  • community_*.md -- One synthesis page per code community
  • connections.json -- Typed bridges between communities
  • queries.md -- Suggested questions + answer log
  • REPORT.md -- Honest audit: coverage, confidence, limits
• readmenator-graphrag/ -- Zero-token GraphRAG index.
  • index.json + REPORTS.md -- Query with readmenator . ask "<question>"
• readmenator-apidocs/ -- API reference (Sphinx/Doxygen style).
  • index.md + modules/*.md -- Signatures, parameters, returns, raises, examples, call graphs
  • architecture.md -- Tiered architecture + execution flows (control flow, call tree, sequence)
  • classes.md, genindex.md, COVERAGE.md -- Hierarchy, A-Z index, doc coverage + warnings
  • index.html + api/ -- Offline searchable browser and machine-readable model (api/index.json, api/modules/*.jsonl one entity per line)
• readmenator-maps/ -- Interactive gallery (index.html).
  • 5 system maps: architecture, workflow, sequence, dataflow, lifecycle
  • graph-force.html -- Force-graph explorer (2D/3D, reach, paths, lenses)
  • graph-bundle.html -- Edge bundle explorer (circle + sphere)
  • components.html -- Component diagrams
• docs/ -- Static site (GitHub Pages ready).
  • Gallery copy + llms.txt (agent entry point) + md/ docs + video
• readmenator-diagrams/ -- Component diagrams.
  • analysis.json + graph LR markdown + per-component pages + index.html
• readmenator-rules/ -- Suggested Semgrep rules (*.yml), yara_rules.yar (YARA-lite) + exclusions.yaml (false-positive blocklist)
• readmenator.mp4 -- Cinematic synthwave overview video
• .cursorrules -- Generated AI assistant rules
• readmenator_audit.sarif -- SARIF v2.1.0 audit (when security scan is on)

Cache (.readmenator_cache/), packaged agent skills (.claude/skills/), and the GitHub wiki mirror are also produced on run/--rebuild.

AI agents: Read readmenator-wiki/index.md first for the big picture, then readmenator-agent/INDEX.md for grep-friendly lookup. Developers: Read KNOWLEDGE_BASE.md for full architecture reference, open readmenator-maps/index.html for the visual gallery.

---

Deployed with deploynator