Skip to content

About

OodleForge Exact reconstruction • AES-256 • Multi-method Oodle • Memory Beast async I/O

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

🦑 OodleForge v34.1

Exact byte-for-byte reconstruction. 11x faster than Wine.

Advanced Multi-Method OodleLZ Archive Engine | v34.1

Build Status C++ Platform

Exact Reconstruction • AES-256 • Full Kraken/Leviathan/Mermaid/Selkie/Hydra • Async 64 MB Memory Beast I/O • Dynamic Discovery Scanner

Oodleforge banner

---

45 Days on Potato Hardware

The original diary started on a 2007 Q6600 + HD 6450 with four LLMs (Qwen, Claude, Grok, Gemini) fighting for dominance.
The 11-day upgrade turned it into a production monster:

  • Memory Beast ring buffer + pipeline queue reduced to 2x
  • Full WalkOodleChain + 32 MB probe buffer
  • Tuned windows (64 MB / 32 MB), safer AES padding, thread-safe FastStreamWriter
  • Native Linux dlopen + exact byte-perfect recon

🚀 Overview

OodleForge is a high-performance C++ CLI tool for exact reconstruction and encoding of OodleLZ-compressed archives. It fully supports all modern Oodle methods (Kraken 8/11, Leviathan, Mermaid 9, Selkie, Hydra 13 this one is -EXPERIMENTAL-) with per-block AES-256-CBC encryption.

Born from 45 days of intense development on legacy hardware (Core 2 Quad Q6600, 8GB RAM)

⚡ Key Features

Feature Specification
Reconstruction Exact byte-for-byte fidelity
Performance 11x faster than Wine
Cryptography AES-256-CBC encryption (per-block)
Memory Model "Memory Beast" — 64MB ring buffer
Methods Full Kraken, Leviathan, Mermaid, Selkie, Hydra
Version 34 (PREF! enabled)
Linux
ENC [99.97%] Blk: 8521 [E:8509 F:12] | 5.58 MB/s | Time: 00:01:24 | ETA: 00:00:00 | Size: 876.01 MB
--- Encoder Processing Metrics ---
Input File Size:        472.88 MB
Processed Output Size:  876.92 MB
Exact Matches: 8523 (99.86%)
Full Fails:    12
Methods Used: 8+9
Levels Used:  4
Total Duration:    00:01:25


Wine
ENC [100.00%] Blk: 8530 [E:8413 F:117] | 0.51 MB/s | Time: 00:15:35 | ETA: 00:00:00 | Size: 871.28 MB
--- Encoder Processing Metrics ---
Input File Size:        472.88 MB
Processed Output Size:  871.65 MB
Exact Matches: 8418 (98.63%)
Full Fails:    117
Methods Used: 8+9
Levels Used:  4
Total Duration:    00:15:35

What started as a clicking hard drive and a dream became a battle against:

  • 🐙 The Kraken — Oodle's compression algorithm
  • 🧠 The Memory Beast — 64MB ring buffer management
  • 🥔 Potato Hardware — The environmental hazard
  • ⏱️ 45 Days — The time pressure mechanic

🏗️ Core Architecture

OodleForge is built on three elite architectural pillars:

1. Async I/O & Memory Pipeline ("Memory Beast") ⭐

Multi-threaded asynchronous I/O with double-buffered ring buffers that overlap disk reads, decompression tasks, and AES cryptographic passes. By decoupling I/O disk bounds from computational bounds, the CPU pipeline never starves — achieving raw hardware saturation even on legacy systems.

2. Atomic Telemetry & Progress Tracking ⭐

Real-time statistics without bottlenecking worker threads:

  • Atomic counters using std::memory_order_relaxed — zero mutex contention
  • Exponential Moving Average (EMA) for stable ETA computation
  • Decoupled UI layer on a dedicated ticker thread (10-30 Hz)

3. Exact Reconstruction & AES-256 Integrity ⭐

Zero margin for error. Explicit task boundaries ensure the exact file structure, compression flag states, and dictionary histories are precisely cataloged and mirrored back to the byte across the AES-256 boundary.


👥 The "Team of Two" Development Methodology

Building an archive engine of this complexity solo within a tight timeframe on a legacy Linux/Wine environment required strict architectural discipline.

The Human-AI Supervision Framework:

Principle Implementation
Task Contracts over Prompt Prose Small, isolated, atomic tasks eliminate context poisoning and logical decay
Human-Owned Architecture Structural validation stays in human hands — no hallucinatory dependencies
Early Integration & Stress Testing Real behavior under heavy I/O pressure

📖 About

This tool lets you:

  • Perfectly detect and extract Oodle blocks
  • Build byte-for-byte exact archives
  • Reconstruct original files with 100% fidelity
  • Use AES-256 encryption

🛠️ Features

  • Full Oodle support (Kraken, Leviathan, Mermaid, Selkie, Hydra)
  • AES-256-CBC encryption (per-block)
  • Async Double-Buffered I/O (64 MB Memory Beast)
  • Threaded pipeline with backpressure
  • Exact-match verification (no false positives)
  • Automatic level detection (-auto) + brute-force mode
  • Professional UI with ETA and real-time stats
  • Scan mode for format analysis
  • Perfect round-trip reconstruction

🚀 Getting Started

Requirements

  • oo2core_9_win64.dll or oo2core_8_win64.dll (or Linux equivalent)

Build

Windows (MinGW64):

make -f Make.windows (for legacy potato)

or

make -f Make.windows.avx2

Linux (native):

make -f Make.linux (for legacy potato)

or make -f Make.linux.avx2


💻 Usage

Basic Syntax

oodleforge.exe <input_file> [output_file] [options]

Operations:

  • e — Encode (create .oodle archive)
  • r — Reconstruct (restore original file)
  • scan — Quick analysis mode

Examples

Basic encoding with auto-detection

oodleforge.exe e game_data.bin game_data.oodle -m kraken -auto

Multi-method encoding with specific levels

oodleforge.exe e assets.pack assets.oodle -m kraken+leviathan -level 5+7

Encoded with AES-256 key

oodleforge.exe e secure.bin secure.oodle -k 2b7e151628aed2a6abf7158809cf4f3c...

Reconstruct from archive

oodleforge.exe r archive.oodle restored.bin


💡 Pro Tips

  • Always run a -scan 1.0 or -scan 5.0 first on unknown files
  • -auto usually finds the perfect level
  • Keep oo2core_*.dll in the same folder as the executable

📜 Version History

  • v34.1 (July 2026) Extreme Memory Discipline, SIMD Hot-Path Optimization, Cryptographic Type Safety, and Bulletproof Malicious File Resistance.
  • v34 (July 2026) Memory Discipline, I/O Tracking Accuracy, Core Compilation Stability, Lock-Free Performance, Hardware-Accelerated Scanning, Wine Compatibility fixed for AVX2, and Bulletproof Correctness.
  • v33.4 (June 2026) Scanner Robustness, Advanced Block Detection, and Critical Buffer Fixes
  • v33.3 (June 2026) — Engine-Specific Compatibility, Expanded Method Support & Scanner Robustness
  • v33.2 (June 2026) — Threading Stability, Cryptographic Integrity, and Resource Efficiency
  • v33.1 (June 2026) — The Memory Beast — Async Double-Buffered I/O + major performance improvements + pacing removed
  • v33.0 — Multi-Method Edition — Full support for Kraken + Leviathan + Mermaid + Selkie + -auto / -force
  • v32.x — AES + basic encode/reconstruct
  • Original OodleForge (34 days on 2010 PC) — The foundation

🤝 Community

Oodleforge thrives on collaboration.
The Memory Beast async I/O system was idea of wrathma.

https://www.fileforums.com/showpost.php?p=510277&postcount=181

We are grateful to everyone who has helped make this tool better.


Happy Kraken Hunting!

May your matches be many, your fails be few, and your MB/s forever high.

— The Oodleforger

🎵 OST: https://www.youtube.com/watch?v=NCfNOwJ8BNs

About

OodleForge Exact reconstruction • AES-256 • Multi-method Oodle • Memory Beast async I/O

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages