Skip to content

Lucaas-o/Universal-Decryptor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Universal Decryption Tool

A powerful, modular Python-based tool designed to decrypt a wide variety of ciphers by intelligently identifying encryption methods and producing human-readable results. Whether you're a CTF player, a puzzle enthusiast, or a student of cryptography, this tool offers professional-grade automated and manual decryption capabilities.

Features

  • 🚀 Automated Engine: Attempts multiple decryption methods (Caesar, Vigenère, XOR, Base64, etc.) and ranks them by linguistic confidence using NLTK-backed scoring.
  • 🛠️ Expanded Manual Mode: Supports 13+ specific decryption methods including classical, complex, and modern ciphers with customizable keys.
  • 🧠 Smart Vigenère Cracker: Automatically identifies key lengths using Index of Coincidence (IC) and cracks keys via frequency analysis.
  • ⚡ CLI & Interactive Support: Use the colorful interactive menu or pass arguments directly for fast automation.
  • 📊 Detailed Metrics: Displays confidence percentages and scoring based on English word distributions.
  • 💾 Logging & Export: Save single results or entire session logs for later analysis.

Installation

  1. Install Python: Python 3.13+ recommended.
  2. Clone the Repository:
    git clone https://github.com/yourusername/Universal-Decryptor.git
    cd Universal-Decryptor
  3. Install Dependencies:
    pip install -r requirements.txt

Usage

Interactive Menu

python decryptor.py

CLI Arguments

# Automated decryption
python decryptor.py --auto "Khoor"

# Jump to manual menu
python decryptor.py --manual

Supported Ciphers

Category Ciphers
Classical Caesar, ROT13, Atbash, Affine, Rail Fence
Complex Vigenère (Auto-crack), Playfair, Hill (2x2)
Encoding Base64, Base32, Hexadecimal, Binary, URL
Modern XOR (Single-byte & Multi-byte keys), Hash Detection
Esoteric Morse Code, Bacon Cipher

How It Works

  • Refined Scoring: Uses NLTK's punkt and words corpora combined with pyenchant (optional) to validate results.
  • Pattern Prioritization: Detects binary, hex, and Morse patterns to give them a scoring bonus.
  • Periodic Analysis: Uses frequency-based delta analysis to crack polyalphabetic ciphers like Vigenère.

Contributing

  1. Fork the repo and create your feature branch.
  2. Ensure tests pass by running pytest tests/test_all.py.
  3. Open a Pull Request!

License

This project is licensed under the MIT License - see the LICENSE file for details.

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors

Languages