HoloPack
A cross-platform archive tool that extracts all major formats and provides .hpak — an open-source archive format with error correction and independent volumes.
Why HoloPack?
Four capabilities that set .hpak apart from traditional archive formats.
Error Correction (ECC)
Built-in Reed-Solomon codes detect and repair data corruption. PAR recovery volumes can reconstruct entire missing volumes. Configurable 5–30% redundancy.
Independent Volumes
Each split volume carries a full catalog and can be extracted on its own — no need to have all volumes present. Inspired by holographic film fragments.
True Encryption
AES-256-GCM with Argon2id key derivation. Encrypt filenames, catalog, and data independently. Optional external key URL for paid content distribution.
AI Manifest
Machine-readable self-describing metadata embedded in every archive. Content type, language, license, keywords, and file statistics — queryable via HTTP Range.
Multi-Format Support
Extract ZIP, 7z, RAR, tar.gz, tar.bz2, tar.xz, tar.zst. Create .hpak and .zip. Automatic encoding detection fixes garbled filenames across platforms.
Remote Operations
HTTP Range fetch downloads specific files from remote archives on demand. Pack and upload directly to HTTP PUT / SFTP / FTP servers in one command.
Smart Extraction
Auto-creates a folder named after the archive to prevent file scattering. Detects ZipCrypto and warns about weak encryption. Parallel compression with Zstd.
Desktop GUI
Tauri v2 native app with drag-and-drop, file preview, built-in help documentation, and 22 language support. Two buttons to start — Open or Compress.
C-ABI & Python Bindings
libholopack shared library (.dll / .so / .dylib) with 17 exported functions. Python bindings included. Integrate HoloPack into any application.
Complete Feature List
18 CLI commands, a desktop GUI, and a C-ABI library — everything you need.
Quick Wrap
Wrap existing ZIP/7z/tar archives into .hpak without re-extracting. Adds ECC protection and AI Manifest to any archive instantly.
Metadata Editing
hpak tag modifies AI Manifest in-place. Set description, keywords, license, content type. Supports batch operations across multiple archives.
Batch Scripts
.batchmd format defines bulk pack / wrap / convert / tag jobs. Run with hpak batch run and optional parallel execution.
Exclusion Rules
.hpakignore file + --exclude CLI patterns + built-in defaults. Flexible control over what goes into your archive.
Tree View
--tree flag displays archive contents as a directory tree. Quick visual overview of what's inside without extracting.
Checksum & Diff
hpak checksum exports Blake3 hashes. hpak diff compares two archives file by file. --dry-run previews without creating.
Presets
Compression: --preset fast|balanced|max. Split volumes: --split email|fat32|dvd|bd. Sensible defaults for common scenarios.
System Integration
hpak install registers context menus and file associations on Windows, Linux (.desktop + MIME), and macOS (duti).
Stdout Pipe
--stdout outputs a single file's content to the pipe. Integrate with other CLI tools without extracting to disk.
Format Comparison
How .hpak stacks up against established archive formats.
| Feature | ZIP | 7z | RAR | .hpak |
|---|---|---|---|---|
| Open Source | Yes | Yes | No | Yes |
| Error Correction | No | No | Yes | Yes (ECC + PAR) |
| Independent Volumes | No | No | No | Yes |
| Encrypted Filenames | No | Yes | Yes | Yes |
| Compression | Deflate | LZMA2 | RAR5 | Zstd |
| Checksum | CRC32 | CRC32 | — | Blake3 |
| Encoding Auto-fix | No | No | No | Yes |
| AI Self-description | No | No | No | Yes |
| HTTP Range Access | Partial | No | No | Yes |
Quick Start
Get productive in seconds with the hpak command-line tool.
Extract
hpak unpack photos.zip # auto-creates photos/ hpak unpack archive.7z -o ./output hpak unpack data.tar.gz
Create Archive
hpak pack ./project -o project.hpak hpak pack ./project -o project.hpak --ecc 10 hpak pack ./project -o project.zip hpak pack ./data --preset fast hpak pack ./data --exclude "*.log"
Verify & Repair
hpak check project.hpak # verify integrity hpak repair project.hpak # repair using ECC hpak checksum archive.hpak # export blake3 hashes hpak diff old.hpak new.hpak # compare archives
Split Volumes
hpak pack ./data -o data.hpak --split 2G --ecc 10 hpak unpack data.vol001.hpak # each volume is independent
Quick Wrap & Tags
hpak wrap archive.zip # wrap into .hpak hpak tag archive.hpak --description "Dataset v2" hpak convert data.zip # full repack to .hpak
Remote Operations
hpak remote-list https://example.com/data.hpak hpak pack ./data -o sftp://user@host/data.hpak hpak batch run jobs.batchmd # batch processing
Architecture
Built on proven, battle-tested technologies.
64 B
Zstd compressed
MessagePack
Reed-Solomon
48 B
Desktop GUI
A clean, focused interface — not a file manager. Two buttons to start.
Drag & Drop
Drop an archive to extract, drop files to compress. Automatic detection.
File Preview
Click any file in the list to preview images, text, and binary content.
Compression Settings
Format, level slider, ECC, password, volume size — advanced options stay collapsed.
Built-in Help
10-chapter help documentation accessible from the top-right corner button.
22 Languages
Auto-detects system language. Switch instantly from the status bar dropdown.
Dark Mode
Follows system settings. Clean, modern design inspired by native OS aesthetics.
Download
Pre-built binaries for all major platforms. Or build from source.
Build from Source
Requires Rust toolchain. GUI additionally requires Tauri v2 CLI.
CLI & Library
git clone https://github.com/Abaodisk-LLC/HoloPack.git cd HoloPack cargo build --release # Output: # target/release/hpak (CLI) # target/release/libholopack (.so / .dylib / .dll)
GUI (Tauri v2)
cargo install tauri-cli --version "^2" cargo tauri build # Linux dependencies: sudo apt-get install -y build-essential pkg-config \ libssl-dev libgtk-3-dev libwebkit2gtk-4.1-dev \ libappindicator3-dev librsvg2-dev patchelf
22 Languages
CLI and GUI fully localized. Auto-detects system language.
Documentation
Comprehensive guides, specifications, and references.
User Guide
Online manual with tutorials and examples
Format Spec
.hpak binary format technical specification
Batch Scripts
.batchmd format for bulk operations
AI Manifest
Machine-readable metadata reference
Tags Convention
Naming conventions for archive tags
Design Philosophy
Compatibility First
Support all major formats well so users have a compelling reason to install. HoloPack is a universal tool first, a new format second.
Usability > Compression Ratio
Being able to open your data matters more than saving 1%. Data availability and fault tolerance are the primary goals.
Pragmatic Engineering
Built on proven technologies — Zstd, Blake3, Reed-Solomon, AES-256-GCM. No reinventing the wheel.
The Name
In holography, a fragment of the film still contains the complete image. HoloPack borrows this concept — each volume carries enough information to be extracted independently. The project was born from two questions: Can each volume of a split archive work on its own? and Can an archive format have built-in data repair?