Dear Kali Linux Development Team,
I am writing to request the inclusion of Hash Calculator in the official Kali Linux repository. I believe this tool would be a valuable addition to Kali's penetration testing toolkit as a comprehensive file integrity verification and hash comparison utility.
PROJECT OVERVIEW
Project Name: Hash Calculator
Repository: https://github.com/bI8d0/hash-calculator
Version: 1.0.0
License: MIT
DESCRIPTION
Hash Calculator is a cross-platform command-line tool written in Go that calculates and verifies file integrity by computing multiple cryptographic hash algorithms (MD5, SHA1, and SHA256) simultaneously. The tool provides interactive hash comparison capabilities, allowing users to verify that calculated hashes match known good hashes, ensuring file integrity and detecting any modifications or tampering.
Key Capability: Interactive hash verification mode that compares calculated hashes against user-provided hashes to instantly verify file integrity.
FEATURES
- Simultaneous Hash Calculation: Computes MD5, SHA1, and SHA256 in a single pass for efficiency
- Interactive Hash Comparison: Compare calculated hashes against provided values with automatic format normalization (uppercase, whitespace removal)
- Instant Verification Result: Clear visual feedback (green/red) indicating if hashes match
- Large File Support: Efficient streaming for files of any size
- Cross-platform Support: Windows, Linux, macOS
- Zero External Dependencies: Uses only Go standard library for security and portability
- ANSI Color-Coded Output: Enhanced readability with green (success) and red (failure) indicators
- Optimized Binary: 0000040:0000050% size reduction through compile-time optimization
WHY THIS TOOL IS VALUABLE FOR KALI LINUX
Hash Calculator directly supports several critical penetration testing and cybersecurity workflows:
- File Integrity Verification: Calculate hashes and instantly compare against known good values to detect modifications or corruption
- Malware Analysis: Generate file hashes and compare against threat intelligence databases to identify suspicious files
- Evidence Preservation: Document file integrity with hash comparisons for forensic investigations and compliance requirements
- Post-Exploitation: Quickly verify that system files maintain integrity after security assessments
- Supply Chain Security: Validate downloaded tools and binaries by comparing calculated hashes against official published hashes
- Rapid Hash Comparison: Built-in verification eliminates manual hash comparison errors - essential for high-volume security work
TECHNICAL SPECIFICATIONS
Build System
- Written in: Go 1.24
- Build system: Standard Go build with optimization flags (-ldflags="-s -w")
- Architecture: amd64 (x86-64)
- Binary size: 0000022:0000008-10 MB (optimized for minimal footprint)
Debian Packaging
- Package format: .deb (Debian/Ubuntu compatible)
- Architecture: amd64
- Installation path: /usr/bin/hash-calculator
- Dependencies: None (statically compiled Go binary)
- Build dependencies: debhelper (>= 13), golang-go (>= 1.21)
Documentation
- README (English): Comprehensive installation and usage guide
- Build guide: Instructions for creating .deb packages
- GitHub Actions: CI/CD pipeline for automated builds and releases
- Code comments: All source code fully documented in English
INSTALLATION & USAGE
Install from Package
sudo dpkg -i hash-calculator_1.0.0-1_amd64.deb
hash-calculator -h
Build from Source
git clone https://github.com/bI8d0/hash-calculator.git
cd hash-calculator
go run build.go
Usage Examples
Example 1: Calculate and Compare Hash
hash-calculator -f /path/to/file
# Output shows MD5, SHA1, SHA256
# Then prompts to enter a hash for verification
# Automatically compares and shows if match (✓) or no match (✗)
Example 2: Quick Hash Generation
hash-calculator -f ~/Downloads/file_name
Example 3: Display Help
hash-calculator -h
QUALITY ASSURANCE
✓ All code is documented in English
✓ Follows Go best practices and conventions
✓ No external dependencies (enhanced security)
✓ Successfully builds on Windows, Linux, and macOS
✓ Debian package builds and installs correctly (.deb format validated)
✓ Open source with MIT license
✓ GitHub repository with clean commit history
✓ Cross-platform testing completed
✓ Hash comparison functionality thoroughly tested
REPOSITORY STRUCTURE
hash-calculator/
├── main.go # Main application logic with hash comparison
├── build.go # Cross-platform build script
├── go.mod / go.sum # Go dependencies (none)
├── debian/ # Debian package configuration
│ ├── control # Package metadata
│ ├── rules # Build instructions
│ ├── changelog # Version history
│ ├── compat # Compatibility level
│ └── copyright # License information
├── README.md # Documentation
├── LICENSE # MIT License
└── .github/workflows/ # GitHub Actions CI/CD
RELEASE INFORMATION
CONTACT INFORMATION
Author: bI8d0
GitHub: https://github.com/bI8d0/hash-calculator
COMPLIANCE & STANDARDS
- Adheres to Debian packaging standards
- Follows Semantic Versioning
- MIT License (compatible with Kali Linux)
- No license conflicts or restrictions
- Code available for security review
I am committed to maintaining this project and providing timely updates. I am also available to address any questions or requirements from the Kali Linux development team.
Thank you for considering Hash Calculator for inclusion in the Kali Linux repository. I look forward to hearing from you.
Best regards,
bI8d0 |