███  █████ █████    █████  ███   ███  █     █   █ ███ █████
                         █       █   █          █   █   █ █   █ █     █  █   █    █
                         █       █   ████       █   █   █ █   █ █     ███    █    █
                         █       █   █          █   █   █ █   █ █     █  █   █    █
                          ███    █   █          █    ███   ███  █████ █   █ ███   █

CTF-Toolkit

CTF-Toolkit is a lightweight command-line toolkit designed for CTF enthusiasts and security researchers. It helps you quickly decode classical ciphers, crack hashes, and automate common crypto and reversing tasks.

Current Features

• Cross-platform (Linux, macOS, Windows) Python-based CLI toolkit.
• Hash cracking with dictionary attacks supporting 50+ hash types: Raw (MD4, MD5, SHA-1/224/256/384/512, SHA3, Keccak, Blake2), Crypt-based (descrypt, md5crypt, sha256crypt, sha512crypt, SunMD5), HMAC / PBKDF2 variants, Windows (NTLM, NetNTLMv2, MSCHAPv2), Database (MySQL, MSSQL, PostgreSQL, Oracle), Django, PHPS2, and more.
• Vigenere cipher decoding.
• Encoding / Decoding tools: Base64, Base32, Hex, URL, Binary, ROT13, ROT47, Caesar, Atbash, Reverse, ASCII converter.
• XOR cipher with key-based encryption and single-byte brute-force.
• Arrow-key navigated TUI menu with green selection indicator.
• Modular class-based architecture for easy extension.

Upcoming Features

• More classical ciphers (Affine, Beaufort, etc.).
• Frequency analysis and pattern detection.
• Workspace mode for saving outputs.
• Modular plugin system for community extensions.

Installation Guide

Prerequisites

Ensure you have the following installed on your system:

• Git version 2.45.1 or higher
• Python version 3.14.0 or higher

Linux / macOS

Step 1: Open Terminal

Step 2: Clone the Repository

git clone https://github.com/zyin-jessie/PwnStar-Toolkit.git
cd PwnStar-Toolkit

Step 3: Make the Launcher Executable

chmod +x pwnstar

Step 4: Add to PATH (optional — lets you run pwnstar from anywhere)

echo 'export PATH="$PATH:'"$(pwd)"'"' >> ~/.bashrc
source ~/.bashrc

Step 5: Launch the Toolkit

./pwnstar

Or from anywhere after adding to PATH:

pwnstar

Windows

Step 1: Open Command Prompt

• Press Windows + R, type cmd, and press Enter
• Or search for "Command Prompt" in the Start menu

Step 2: Navigate to Root Drive

cd C:\

Step 3: Clone the Repository

git clone https://github.com/zyin-jessie/CTF-Toolkit.git

Step 4: Add to System PATH

• Search for "Environment Variable" in the Start menu
• Click "Edit the system environment variables"
• Click "Environment Variables" button
• Under "User variables", select "Path" and click "Edit"
• Click "New" and add the following path:

C:\CTF-Toolkit

Step 5: Launch the Toolkit

• Open a new Command Prompt window
• Type the following command:

pwnstar