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

This site is open source. Improve this page.