hasher GavinGe021

hasher – High-performance Multi-algorithm Hash Calculator

中文文档 | 简体中文

<<<<<<< HEAD Version 2.1.0 – Now with GUI, auto-optimization, and parallel hashing!

hasher is a lightweight, high-performance command-line tool for computing hash digests of files or strings. Built on OpenSSL 3.x EVP, it supports 20+ algorithms with asynchronous I/O, batch parallel processing, and an intelligent progress bar.

======= hasher is a lightweight, high-performance command-line tool for computing hash digests of files or strings. Built on OpenSSL 3.x EVP, it supports 20+ algorithms with asynchronous I/O, batch parallel processing, and an intelligent progress bar.

Version 2.0.0 introduces HMAC, checksum verification/generation, JSON/CSV output, colorized output, and configuration file support.

>>>>>>> 0d407c4574fcf998e4016aa9d7459bdd385d5403

✨ Features

• Multi-algorithm support: MD4, MD5, SHA-1, SHA-2 family, SHA-3, BLAKE2, SM3, RIPEMD-160, Whirlpool, Keccak, and more.
• High performance: Double-buffering + asynchronous I/O fully utilizes CPU and disk bandwidth.
• Parallel processing: Process multiple files concurrently with --threads.
• Smart progress bar: Real-time speed and ETA for large files. <<<<<<< HEAD
• Auto-optimization: Threads and buffer size automatically tuned.
• Parallel single-file hashing: 2–4x speedup for large files.
• GUI interface: Qt-based graphical interface with drag-and-drop, progress bar, taskbar progress, copy/save. ======= >>>>>>> 0d407c4574fcf998e4016aa9d7459bdd385d5403
• HMAC support: --hmac for keyed-hash message authentication.
• Check mode: --check to verify checksums (like sha256sum -c).
• Generate mode: --generate to output standard checksum files.
• JSON/CSV output: --format json or --format csv for script integration.
• Colorized output: --color always/never/auto to control terminal colors.
• Config file: ~/.hasher/config for persistent settings. <<<<<<< HEAD
• Pipe input: echo -n hello | hasher.
• Wildcard support: --check "*.sha256".
• Cross-platform: Native I/O on Windows and Linux.

📦 Installation

Pre-built Binaries (Recommended)

Download the installer for your platform from the Releases page:

• hasher-2.1.0-setup.exe – GUI version (Windows)
• hasher-cli-2.1.0-setup.exe – CLI only (Windows)
• hasher (Linux/macOS) – static binaries

=======

• Cross-platform: Native I/O on Windows and Linux with no performance compromise.

📦 Installation

>>>>>>> 0d407c4574fcf998e4016aa9d7459bdd385d5403

Build from Source

git clone https://github.com/GavinGe021/hasher.git
cd hasher
make
# Or manually:
# g++ -std=c++17 -O3 -pthread -o hasher hasher.cpp -lcrypto -lssl

<<<<<<< HEAD

Dependencies: OpenSSL 3.x dev libraries (libssl-dev / openssl-devel).

# Dependencies: OpenSSL 3.x dev libraries (libssl-dev / openssl-devel)

Pre-built Binaries (Recommended)

Download the static binaries for your platform from the Releases page.

Package Managers (Community Maintained)

• Windows (winget): winget install hasher (submission pending)
• Windows (Chocolatey): choco install hasher
• Linux (APT): Coming soon via PPA
• macOS (Homebrew): brew install hasher >>>>>>> 0d407c4574fcf998e4016aa9d7459bdd385d5403

🚀 Usage

hasher [OPTIONS]  [algorithm] [ ...]

Examples

# Basic hash (string)
hasher hello

# File hash
hasher --file myfile.iso

# Auto-detect (file if exists, else string)
hasher myfile

# Specify algorithm
hasher hello sha512

# Parallel processing (4 threads)
hasher --threads=4 file1.iso file2.iso file3.iso

# SHAKE with custom output length (512 bits)
hasher --digest-bits=512 --file data.bin shake256

# HMAC
hasher --hmac mykey hello sha256

# Verify checksums
hasher --check checksum.sha256

# Generate checksum file
hasher --generate output.sha256 file1.bin file2.bin

# JSON output
hasher --format json hello

# Verbose mode with speed
hasher --verbose largefile.bin

<<<<<<< HEAD # Pipe input echo -n hello | hasher

# Wildcard check
hasher --check "*.sha256"

======= >>>>>>> 0d407c4574fcf998e4016aa9d7459bdd385d5403

Options

Option	Description
--help, -h	Show help message
--version, -V	Show version and OpenSSL info
--file	Force treat inputs as file paths
--string	Force treat inputs as literal strings
<<<<<<< HEAD
--progress, -p	Force show progress bar
--no-progress	Disable progress bar
--buffer-size=	I/O buffer size in MB (default: auto)
--threads=	Number of threads (default: auto, max 8)
--verbose, -v	Print speed, time, and split hashes
=======
--progress, -p	Force show progress bar (single file only)
--no-progress	Disable progress bar
--buffer-size=	I/O buffer size in MB (default: 64)
--threads=	Number of parallel file processes (default: 1)
--verbose, -v	Print speed, time, and split hashes for md5-sha1
>>>>>>> 0d407c4574fcf998e4016aa9d7459bdd385d5403
--digest-bits=	Output bits for SHAKE algorithms
--format	Output format: text, json, csv

Supported Algorithms

md4, md5, md5-sha1, sha1, sha224, sha256, sha384, sha512, sha512-224, sha512-256, sha3-224, sha3-256, sha3-384, sha3-512, shake128, shake256, blake2b512, blake2s256, ripemd160, sm3, whirlpool, mdc2, keccak224, keccak256, keccak384, keccak512

> Note: Algorithms like MD4, MD5, and SHA-1 are cryptographically broken. The tool will display a warning when they are used.

⚙️ Configuration

Create ~/.hasher/config with key = value pairs. Supported keys:

• default_algorithm – default hash algorithm (e.g., sha256)
• buffer_size_mb – I/O buffer size in MB
• color – auto, always, never
• format – text, json, csv
• progress – true / false
• threads – number of parallel processes
• verbose – true / false

Environment variable HASHER_CONFIG can override the config file path.

📊 Performance

On a test environment (NVMe SSD + Intel i7), hashing a 10GB file with SHA-256 achieves ~600 MB/s. Parallel mode fully utilizes multi-core CPUs.

🔒 Security

• This tool is for hash computation only; it does not handle encryption or authentication.
• Users are responsible for the risks of using weak algorithms (the tool displays warnings).

🤝 Contributing

Issues and Pull Requests are welcome. Please ensure your code is C++17 compatible and follows OpenSSL usage guidelines.

📜 License

This project is licensed under the MIT License. OpenSSL 3.x is used under the Apache 2.0 License. See the LICENSE file for details.