v1.0.0 — Open Source & Free Forever

Recover Files That
Other Tools Abandon

A corrupt archive recovery engine built in Rust. Fail-forward architecture saves every recoverable file — even from severely damaged ZIP, RAR, 7z, and tar.gz archives.

29
File Signatures
179
Tests Passing
7
Archive Formats
0
Clippy Warnings
helix-salvager — bash

Standard Tools Give Up. Helix Doesn't.

When archives are corrupted, traditional tools abort the entire extraction. Helix uses fail-forward architecture to save everything that can be saved.

Traditional Tools

  • CRC mismatch → entire extraction aborts
  • Corrupted header → "file not recognized"
  • LZMA stream error → zero files recovered
  • Damaged Central Directory → gives up
  • One bad file kills the whole batch

Helix Salvager

  • CRC errors bypassed — files still extracted
  • Magic-header carving recovers raw files
  • Zombie LZMA decoder resumes after corruption
  • Scans raw bytes — no headers needed
  • Fail-forward: every good file is saved

Built for the Worst-Case Scenario

Three recovery engines work together to maximize what gets saved.

🧬

Magic-Header Carving

Aho-Corasick multi-pattern scan detects 29 file signatures in a single pass — JPEG, PNG, PDF, ZIP, ELF, SQLite, and more.

Fail-Forward ZIP

Bypasses CRC validation errors and continues extracting. One corrupted file doesn't kill the entire archive.

🧟

Zombie LZMA Decoder

Custom LZMA stream decoder that recovers partial data from corrupted compressed streams instead of aborting.

🔍

Deep Validation

14 file-type validators check internal structure — PNG chunk integrity, JPEG markers, PDF cross-references, ELF headers.

🔌

Plugin System

Define custom file signatures via JSON. Load proprietary formats, niche file types, or internal data structures.

💾

Disk Image Scanning

Parse .img/.dd/.raw files with MBR and GPT partition detection. Recover files from forensic disk images.

🌊

Streaming Mode

Memory-mapped sliding window processes multi-gigabyte files without loading them entirely into RAM.

⚙️

Parallel Processing

Rayon-powered parallel SHA-256 deduplication. Multi-core acceleration for large recoveries.

🌐

Web UI & REST API

Drag-and-drop web interface powered by actix-web. Upload corrupt files and download recovered data instantly.

How It Works

Three-engine pipeline with automatic fallback and deduplication.

📦
Corrupt Archive
ZIP/RAR/7z/tar.gz
🔧
Engine 1
Fail-Forward Extract
🧟
Engine 2
Zombie LZMA Decode
🧬
Engine 3
Magic-Header Carving
Validate & Dedup
SHA-256 + Structure
0
File Signatures
0
Validators
0
Tests Passing
0
Archive Formats

Supported Formats

Archives and file types detected by the recovery engine.

.zip ZIP
.rar RAR v4/v5
.7z 7-Zip / LZMA
.tar.gz Gzip
.tar.bz2 Bzip2
.tar.xz XZ
.tar TAR
.jpg JPEG
.png PNG
.gif GIF
.bmp BMP
.tiff TIFF
.webp WebP
.ico ICO
.pdf PDF
.mp3 MP3
.mp4 MP4
.flac FLAC
.ogg OGG
.avi AVI
.xml XML
.sqlite SQLite
.wasm WASM
.elf ELF
.exe PE/EXE
.class Java
.dex Android DEX

Install in Seconds

Three ways to get Helix Salvager running.

🦀

Build from Source

git clone https://github.com/vedLinuxian/helix-salvager.git
cd helix-salvager
cargo build --release
🐳

Docker

docker build -t helix-salvager .
docker run -p 3000:3000 \
  helix-salvager
🚀

Quick Start

./start.sh
# Opens web UI at
# http://localhost:3000

Stop Losing Files to Corruption

Helix Salvager is free, open-source, and built to handle the archives other tools refuse to touch.

Star on GitHub Report an Issue