# 🔓 Decryption Toolkit
Decryption Toolkit is a comprehensive Python CLI tool for automatically decoding and decrypting strings using a wide range of classic ciphers and encodings.
[](https://pypi.org/project/DecryptionToolkit/)
[](https://www.python.org/downloads/)
[](https://github.com/Aarav2709/DecryptionToolkit/blob/main/LICENSE)
[](https://pypi.org/project/DecryptionToolkit/)
[](https://github.com/psf/black)
---
## 🚀 Installation
### Option 1: Install from PyPI (Recommended)
Install the latest stable version from PyPI:
```bash
pip install DecryptionToolkit
```
### Option 2: Clone Repository
Clone and run the tool locally:
```bash
git clone https://github.com/Aarav2709/DecryptionToolkit.git
cd DecryptionToolkit
cd DecryptionToolkit
python main.py --help
```
### Option 3: Direct Usage
Run directly after downloading:
```bash
cd DecryptionToolkit/DecryptionToolkit
python main.py 'SGVsbG8gV29ybGQ='
```
---
## ▶️ How to Use
### Basic Commands
#### If installed via PyPI:
```bash
python -c "from DecryptionToolkit import main; main()" 'SGVsbG8gV29ybGQ='
```
#### If running locally (in DecryptionToolkit directory):
#### Auto-Detection Mode (Default)
```bash
python main.py 'SGVsbG8gV29ybGQ='
```
Automatically detects and decodes the input string.
#### Interactive Input Mode
```bash
python main.py -i
```
Prompts you to enter text interactively.
#### Force Specific Decoder
```bash
python main.py -f base64 'SGVsbG8gV29ybGQ='
python main.py -f caesar 'KHOOR ZRUOG'
python main.py -f morse '.... . .-.. .-.. ---'
```
Forces the tool to use a specific decoder type.
#### List All Available Decoders
```bash
python main.py -l
```
Shows all 33+ available decoders with descriptions.
#### Verbose Analysis Mode
```bash
python main.py -v '48656c6c6f20576f726c64'
```
Shows detailed analysis and all decode attempts.
#### String Analysis Only
```bash
python main.py --analyze 'mysterious_string'
```
Analyzes the string without attempting decoding.
#### Quiet Mode
```bash
python main.py -q 'SGVsbG8gV29ybGQ='
```
Shows minimal output (results only).
#### Confidence Threshold
```bash
python main.py --threshold 0.8 'SGVsbG8gV29ybGQ='
```
Sets confidence threshold for auto-detection (0.0-1.0).
#### Disable Colors
```bash
python main.py --no-color 'SGVsbG8gV29ybGQ='
```
Disables colored output for terminals that don't support it.
---
## 🎮 Features
### 🖥️ Core Features
- ✅ Auto-Detection with intelligent confidence scoring
- 🎨 Colorized output with progress bars and icons
- 📊 Entropy analysis and complexity assessment
- 🔧 Multiple operation modes (auto, force, interactive)
- ⚡ High performance with no external dependencies
- 🔌 Extensible architecture for adding new decoders
### 🔍 Supported Decoders (33+ Total)
- **Base Encodings**: Base64, Base32, Base85, UUencode, XXencode
- **Text Encodings**: Hex, Binary, ASCII, URL, HTML, Unicode
- **Substitution Ciphers**: Caesar, ROT13, Atbash, Affine
- **Polyalphabetic Ciphers**: Vigenère, Beaufort, Gromark
- **Polygraphic Ciphers**: Playfair, Four-square, Two-square
- **Transposition Ciphers**: Rail Fence, Columnar
- **Grid/Coordinate Ciphers**: Polybius, Phillips, Bifid, Trifid
- **Advanced Ciphers**: Nihilist, XOR (brute force)
- **Special Formats**: Morse code, Baconian, Timestamp conversion
---
## 📊 Sample Test Strings
Try these encoded strings with the tool:
#### For PyPI installation:
```bash
python -c "from DecryptionToolkit import main; main(['SGVsbG8gV29ybGQ='])"
python -c "from DecryptionToolkit import main; main(['48656c6c6f20576f726c64'])"
python -c "from DecryptionToolkit import main; main(['KHOOR ZRUOG'])"
```
#### For local installation:
```bash
python main.py 'SGVsbG8gV29ybGQ='
python main.py '48656c6c6f20576f726c64'
python main.py 'KHOOR ZRUOG'
python main.py '.... . .-.. .-.. --- .-- --- .-. .-.. -..'
python main.py '01001000 01100101 01101100 01101100 01101111'
python main.py 'Uryyb Jbeyq'
python main.py 'Hello%20World'
python main.py 'SVOOL DLIOW'
```
---
## 🧠 How the Tool Works
- Input any encoded or encrypted string
- The tool analyzes entropy, character distribution, and patterns
- Confidence scores determine the most likely encoding types
- Multiple decoders attempt to process the input
- Results are displayed with success indicators and formatting
---
## 💡 Tips
- Use verbose mode (-v) to see all attempted decoders and their confidence scores
- The tool works best with properly formatted input strings
- For interactive mode, you can test multiple strings without restarting
- Force mode (-f) is useful when you know the specific encoding type
Raw data
{
"_id": null,
"home_page": null,
"name": "DecryptionToolkeet",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "DecryptionToolkeet, Cryptography, Decryption, Cipher, Encoding, CTF, Security",
"author": null,
"author_email": "Aarav Gupta <tribejustice35@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/a6/a6/cf6841b924508bdf225f198fdfe6e4ab1c26b15544d4fd5af82149a80ba9/decryptiontoolkeet-1.0.0.tar.gz",
"platform": null,
"description": "# \ud83d\udd13 Decryption Toolkit\n\nDecryption Toolkit is a comprehensive Python CLI tool for automatically decoding and decrypting strings using a wide range of classic ciphers and encodings.\n\n[](https://pypi.org/project/DecryptionToolkit/)\n[](https://www.python.org/downloads/)\n[](https://github.com/Aarav2709/DecryptionToolkit/blob/main/LICENSE)\n[](https://pypi.org/project/DecryptionToolkit/)\n[](https://github.com/psf/black)\n\n---\n\n## \ud83d\ude80 Installation\n\n### Option 1: Install from PyPI (Recommended)\nInstall the latest stable version from PyPI:\n```bash\npip install DecryptionToolkit\n```\n\n### Option 2: Clone Repository\nClone and run the tool locally:\n```bash\ngit clone https://github.com/Aarav2709/DecryptionToolkit.git\ncd DecryptionToolkit\ncd DecryptionToolkit\npython main.py --help\n```\n\n### Option 3: Direct Usage\nRun directly after downloading:\n```bash\ncd DecryptionToolkit/DecryptionToolkit\npython main.py 'SGVsbG8gV29ybGQ='\n```\n\n---\n\n## \u25b6\ufe0f How to Use\n\n### Basic Commands\n\n#### If installed via PyPI:\n```bash\npython -c \"from DecryptionToolkit import main; main()\" 'SGVsbG8gV29ybGQ='\n```\n\n#### If running locally (in DecryptionToolkit directory):\n\n#### Auto-Detection Mode (Default)\n```bash\npython main.py 'SGVsbG8gV29ybGQ='\n```\nAutomatically detects and decodes the input string.\n\n#### Interactive Input Mode\n```bash\npython main.py -i\n```\nPrompts you to enter text interactively.\n\n#### Force Specific Decoder\n```bash\npython main.py -f base64 'SGVsbG8gV29ybGQ='\npython main.py -f caesar 'KHOOR ZRUOG'\npython main.py -f morse '.... . .-.. .-.. ---'\n```\nForces the tool to use a specific decoder type.\n\n#### List All Available Decoders\n```bash\npython main.py -l\n```\nShows all 33+ available decoders with descriptions.\n\n#### Verbose Analysis Mode\n```bash\npython main.py -v '48656c6c6f20576f726c64'\n```\nShows detailed analysis and all decode attempts.\n\n#### String Analysis Only\n```bash\npython main.py --analyze 'mysterious_string'\n```\nAnalyzes the string without attempting decoding.\n\n#### Quiet Mode\n```bash\npython main.py -q 'SGVsbG8gV29ybGQ='\n```\nShows minimal output (results only).\n\n#### Confidence Threshold\n```bash\npython main.py --threshold 0.8 'SGVsbG8gV29ybGQ='\n```\nSets confidence threshold for auto-detection (0.0-1.0).\n\n#### Disable Colors\n```bash\npython main.py --no-color 'SGVsbG8gV29ybGQ='\n```\nDisables colored output for terminals that don't support it.\n\n---\n\n## \ud83c\udfae Features\n\n### \ud83d\udda5\ufe0f Core Features\n- \u2705 Auto-Detection with intelligent confidence scoring\n- \ud83c\udfa8 Colorized output with progress bars and icons\n- \ud83d\udcca Entropy analysis and complexity assessment\n- \ud83d\udd27 Multiple operation modes (auto, force, interactive)\n- \u26a1 High performance with no external dependencies\n- \ud83d\udd0c Extensible architecture for adding new decoders\n\n### \ud83d\udd0d Supported Decoders (33+ Total)\n- **Base Encodings**: Base64, Base32, Base85, UUencode, XXencode\n- **Text Encodings**: Hex, Binary, ASCII, URL, HTML, Unicode\n- **Substitution Ciphers**: Caesar, ROT13, Atbash, Affine\n- **Polyalphabetic Ciphers**: Vigen\u00e8re, Beaufort, Gromark\n- **Polygraphic Ciphers**: Playfair, Four-square, Two-square\n- **Transposition Ciphers**: Rail Fence, Columnar\n- **Grid/Coordinate Ciphers**: Polybius, Phillips, Bifid, Trifid\n- **Advanced Ciphers**: Nihilist, XOR (brute force)\n- **Special Formats**: Morse code, Baconian, Timestamp conversion\n\n---\n\n## \ud83d\udcca Sample Test Strings\nTry these encoded strings with the tool:\n\n#### For PyPI installation:\n```bash\npython -c \"from DecryptionToolkit import main; main(['SGVsbG8gV29ybGQ='])\"\npython -c \"from DecryptionToolkit import main; main(['48656c6c6f20576f726c64'])\"\npython -c \"from DecryptionToolkit import main; main(['KHOOR ZRUOG'])\"\n```\n\n#### For local installation:\n```bash\npython main.py 'SGVsbG8gV29ybGQ='\npython main.py '48656c6c6f20576f726c64'\npython main.py 'KHOOR ZRUOG'\npython main.py '.... . .-.. .-.. --- .-- --- .-. .-.. -..'\npython main.py '01001000 01100101 01101100 01101100 01101111'\npython main.py 'Uryyb Jbeyq'\npython main.py 'Hello%20World'\npython main.py 'SVOOL DLIOW'\n```\n\n---\n\n## \ud83e\udde0 How the Tool Works\n- Input any encoded or encrypted string\n- The tool analyzes entropy, character distribution, and patterns\n- Confidence scores determine the most likely encoding types\n- Multiple decoders attempt to process the input\n- Results are displayed with success indicators and formatting\n\n---\n\n## \ud83d\udca1 Tips\n- Use verbose mode (-v) to see all attempted decoders and their confidence scores\n- The tool works best with properly formatted input strings\n- For interactive mode, you can test multiple strings without restarting\n- Force mode (-f) is useful when you know the specific encoding type\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "A comprehensive Python CLI tool for automatically decoding and decrypting strings using classic ciphers and encodings.",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/Aarav2709/DecryptionToolkeet"
},
"split_keywords": [
"decryptiontoolkeet",
" cryptography",
" decryption",
" cipher",
" encoding",
" ctf",
" security"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "efffe9fb23482501da572f18593e357c8fae08f5782a29e4069d94d4a2a7bb5a",
"md5": "c3203cc080427172bdd114833c50682d",
"sha256": "0a615e5e1e05a10600cc80d3d978bad1516afe52584daa717cd00e0effdaa12e"
},
"downloads": -1,
"filename": "decryptiontoolkeet-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c3203cc080427172bdd114833c50682d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 7237,
"upload_time": "2025-07-30T16:19:14",
"upload_time_iso_8601": "2025-07-30T16:19:14.906897Z",
"url": "https://files.pythonhosted.org/packages/ef/ff/e9fb23482501da572f18593e357c8fae08f5782a29e4069d94d4a2a7bb5a/decryptiontoolkeet-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a6a6cf6841b924508bdf225f198fdfe6e4ab1c26b15544d4fd5af82149a80ba9",
"md5": "c29a74c44a4853c151e3a20ba85e5db4",
"sha256": "42d3f8e94a7d7e17a1c0e7ccd3ad9eed52d4ffe0453f50631ba8a1004e54ce6b"
},
"downloads": -1,
"filename": "decryptiontoolkeet-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "c29a74c44a4853c151e3a20ba85e5db4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 6479,
"upload_time": "2025-07-30T16:19:16",
"upload_time_iso_8601": "2025-07-30T16:19:16.644493Z",
"url": "https://files.pythonhosted.org/packages/a6/a6/cf6841b924508bdf225f198fdfe6e4ab1c26b15544d4fd5af82149a80ba9/decryptiontoolkeet-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-30 16:19:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Aarav2709",
"github_project": "DecryptionToolkeet",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "decryptiontoolkeet"
}
JSON
