mirror of
https://github.com/8bit-wraith/zipper-decrypter.git
synced 2026-11-21 22:50:01 +01:00
Upstream pull mirror of https://github.com/8bit-wraith/zipper-decrypter.git
- Python 94.4%
- Shell 5.6%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| example-files | ||
| scripts | ||
| src | ||
| tests | ||
| .gitignore | ||
| context.md | ||
| decryption-helper.md | ||
| README.md | ||
| requirements-dev.txt | ||
| requirements.txt | ||
| setup.py | ||
| wordlist.txt | ||
🔓 zipper-decrypter
A modern, cross-platform password recovery tool for encrypted archives and documents, featuring intelligent wordlist generation and smart password pattern detection.
Features
- 🚀 GPU acceleration support (CUDA, Metal, ROCm)
- 💪 Multi-threaded CPU support
- 📦 Supports ZIP, RAR, 7Z, ODT, and PDF files
- 🔄 Resume capability for interrupted jobs
- 🧠 AI-powered wordlist generation using SwallowMaid model
- 📝 Smart wordlist generation based on personal information
- 🎯 Advanced password pattern detection with affinity mapping
- 🌈 Progress visualization
- 🔒 Secure password handling
Requirements
- Python 3.8+
- For GPU support:
- NVIDIA: CUDA 11.0+
- Apple: macOS 12.0+ with M1/M2/M3 chip
- AMD: ROCm 5.0+
- Optional: SwallowMaid model for AI-powered wordlist generation
Installation
# Create and activate virtual environment
python -m venv .venv
source .venv/bin/activate # On Unix/macOS
.venv\Scripts\activate # On Windows
# Install dependencies
pip install -r requirements.txt
# For NVIDIA GPU support
pip install torch --extra-index-url https://download.pytorch.org/whl/cu118
# For Apple Silicon (M1/M2/M3)
pip install torch --extra-index-url https://download.pytorch.org/whl/nightly/cpu
# For AMD ROCm
pip install torch --extra-index-url https://download.pytorch.org/whl/rocm5.6
Usage
Generating Wordlists
# Generate wordlist using personal information
zipper-decrypter generate-wordlist . \
--personal "Alexandra,ChrisC,Canberra,Volleyball,5040,MyNotes,SecretDiary,5am,6am" \
--output alexandra_wordlist.txt
# Generate AI-powered wordlist from directory content
zipper-decrypter generate-wordlist /path/to/files \
--ai-model SwallowMaid \
--output smart_wordlist.txt
Decrypting Files
# Decrypt using wordlist with pattern affinity
zipper-decrypter decrypt example-files/ImTheWife.odt \
--wordlist alexandra_wordlist.txt \
--patterns "HWNS" \
--affinity "A1:H,A2:W,A3:N,A4:S" \
--min-length 6 \
--max-length 20
# Basic decryption with default settings
zipper-decrypter decrypt encrypted_file.zip \
--wordlist wordlist.txt
# Force CPU mode with specific thread count
zipper-decrypter decrypt encrypted_file.pdf \
--wordlist wordlist.txt \
--cpu-only \
--threads 8
# Resume previous decryption job
zipper-decrypter decrypt encrypted_file.rar \
--resume
Pattern Affinity Explained
The pattern affinity system allows you to map specific characters or patterns to their likely positions in the password:
--patterns: Define the pattern sequence (e.g., "HWNS" for Home-Work-Name-Special)--affinity: Map positions to patterns (e.g., "A1:H" means position 1 likely contains Home-related characters)
This helps optimize the search space based on password creation patterns.
AI-Powered Wordlist Generation
The tool integrates with the SwallowMaid-8B model to generate intelligent wordlists based on:
- Directory content analysis
- Common password patterns
- Personal information correlation
Model: mradermacher/SwallowMaid-8B-L3-SPPO-abliterated-i1-GGUF
- Context Length: 8192 tokens
- Size: ~3.7GB
- Quantization: Q3_K_S
Development
# Install development dependencies
pip install -r requirements-dev.txt
# Run tests
pytest
# Run linting
flake8
# Commit changes (uses custom commit script)
./scripts/commit.sh "Your commit message"
# Project management (test, start, stop, restart)
./scripts/manage.sh [command]
Contributing
Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.
License
Acknowledgments
- John the Ripper for hash formats
- Hashcat for GPU acceleration techniques
- SwallowMaid model for AI-powered wordlist generation
- The amazing open-source community
Made with ❤️ by the zipper-decrypter team