An open API service indexing awesome lists of open source software.

https://github.com/bylickilabs/zip-file-hasher

A powerful Go-based CLI tool to securely hash the contents of ZIP files โ€“ 100% local, GDPR-compliant, with zero external dependencies.
https://github.com/bylickilabs/zip-file-hasher

bylickilabs clitool cybersecurity dataintegrity devopsutilities dsgvocompliant filehashing forensictools golang goprojects jsonoutputparser localprocessingonly md5hasher minimaldependencies opensource release sha256 ziphasher

Last synced: 8 months ago
JSON representation

A powerful Go-based CLI tool to securely hash the contents of ZIP files โ€“ 100% local, GDPR-compliant, with zero external dependencies.

Awesome Lists containing this project

README

          

|[![Go](https://github.com/bylickilabs/ZIP-File-Hasher/actions/workflows/go.yml/badge.svg)](https://github.com/bylickilabs/ZIP-File-Hasher/actions/workflows/go.yml)|
|---|

# ๐Ÿ” ZIP File Hasher

|logo|
|---|

A powerful Go-based CLI tool to securely hash the contents of ZIP files โ€“ 100% local, GDPR-compliant, with zero external dependencies.

โœ… Go Developer

| ![certificate_of_completion_go](https://github.com/user-attachments/assets/b8eca14b-a2fe-4419-abf0-a7d110a07dd2) |
|---|

---

## ๐Ÿš€ Features

- ๐Ÿ—œ๏ธ Handles `.zip` files only
- ๐Ÿ“ Extracts ZIP content into temporary directories
- ๐Ÿ” Supported hash algorithms: `md5`, `sha1`, `sha256`, `sha512`
- ๐Ÿงพ Optional JSON output for automation and integration
- ๐Ÿ›ก๏ธ Fully local processing โ€“ no upload, no cloud, no tracking

---

## ๐Ÿ–ฅ๏ธ Requirements

- [Install Go (version 1.18 or higher)](https://go.dev/dl/)
- Recommended: Windows 10 / 11

---

## ๐Ÿ“ฆ Project Structure

```plaintext
ziphasher/
โ”œโ”€โ”€ main.go # Application entry point
โ”œโ”€โ”€ hasher/
โ”‚ โ””โ”€โ”€ filehash.go # File hashing functionality
โ””โ”€โ”€ zip/
โ””โ”€โ”€ unzip.go # ZIP extraction logic
```

---

## โš™๏ธ Initialization

```yarn
go mod init ziphasher
```

> โš ๏ธ The module name **must match** the import paths in `main.go`.

---

## โ–ถ๏ธ Run

```powershell
go run main.go -zip="your_zip_file.zip" -algo=sha512 -json
```

### ๐Ÿ”ง Parameters

| Parameter | Description |
|-----------|-------------|
| `-zip` | Path to the ZIP file |
| `-algo` | Hash algorithm: `md5`, `sha1`, `sha256`, `sha512` |
| `-json` | Enables JSON output format |

---

## ๐Ÿ”จ Optional: Build

```powershell
go build -o ziphasher.exe
```

Then run via:

```powershell
.\ziphasher.exe -zip="test.zip" -algo=sha256 -json
```

---

## ๐Ÿ“‘ Example Output (JSON)

```json
{
"test.zip_extracted/readme.txt": "abc123def456...",
"test.zip_extracted/docs/manual.pdf": "f7b9aa22bb77..."
}
```

---

## ๐Ÿ‘จโ€๐Ÿ’ป Author & License

BYLICKILABS โ€“ 2025

License: MIT
[LICENSE](LICENSE)