• Python 94.4%
  • Shell 5.6%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2025-01-18 04:26:54 -05:00
example-files Enchanced Wordlists 2025-01-17 21:42:27 -05:00
scripts 🧮 Add integration tests for example files 2025-01-17 20:37:12 -05:00
src checkin 2025-01-18 04:26:54 -05:00
tests 📊 feat: Convert hashcat-utils to Python and integrate with project ✨ Balanced and reconciled! 2025-01-17 20:18:58 -05:00
.gitignore 🎯 Add pattern-based password generation with affinity support. Trish says this is like her spreadsheet formulas - organized and efficient 2025-01-17 22:43:55 -05:00
context.md Enchanced Wordlists 2025-01-17 21:42:27 -05:00
decryption-helper.md checkin 2025-01-18 04:26:54 -05:00
README.md checkin 2025-01-18 04:26:54 -05:00
requirements-dev.txt 🎭 Add encrypted example files by Trish! | 🔐 ZIP, 7Z, PDF with passwords from easy to impossible | 💝 She says they're as secure as her Excel formulas 📊 2025-01-17 19:55:48 -05:00
requirements.txt checkin 2025-01-18 04:26:54 -05:00
setup.py 📝 Rename project to zipper-decrypter 📚 The books are balanced 2025-01-17 19:28:51 -05:00
wordlist.txt checkin 2025-01-18 04:26:54 -05:00

🔓 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

MIT

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