Skip to content

om-jadhav/Caesar-Cipher-Tool

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ” Caesar Hacker

Caesar Cipher Encryption & Attack Toolkit

Caesar Hacker is a Linux-based Python CLI tool that implements Caesar cipher encryption, decryption, brute-force attacks, and automatic English detection.

This project is built for learning cryptography fundamentals, classical cipher weaknesses, and real-world cryptanalysis techniques.


✨ Features

  • πŸ”’ Encrypt text using Caesar Cipher
  • πŸ”“ Decrypt text with a known shift
  • πŸ’£ Brute-force all 26 shifts
  • 🧠 Auto-detect English plaintext
  • πŸ“‚ File input support (-f <file>)
  • 🎨 Colored terminal output
  • 😈 Hacker-style ASCII banner
  • 🐧 Linux executable script
  • ⚑ No external dependencies

🧠 What is Caesar Cipher?

The Caesar cipher is a classical substitution cipher where each letter is shifted by a fixed number of positions.

Example (shift = 3):

A β†’ D B β†’ E Z β†’ C

yaml Copy code


πŸ“¦ Requirements

  • Python 3.7 or higher
  • Linux / WSL / Unix-based terminal

βš™οΈ Installation

1️⃣ Clone the repository

git clone https://github.com/yourusername/Caesar-Cipher-Tool.git

2️⃣ Navigate into the project directory

cd Caesar-Cipher-Tool

3️⃣ Make the script executable

chmod +x CS.py

4️⃣ Verify installation

./CS.py --help

πŸ–₯ Usage

General Syntax ./CS.py [options]

πŸ”’ Encrypt Mode

./CS.py encrypt "HELLO WORLD" 3 ./CS.py encrypt -f plain.txt 5

πŸ”“ Decrypt Mode

./CS.py decrypt "KHOOR ZRUOG" 3 ./CS.py decrypt -f encrypted.txt 3

πŸ’£ Brute-force Mode

./CS.py bruteforce -f encrypted.txt

🧠 Auto-Detect Mode

./CS.py bruteforce -f encrypted.txt --auto

πŸ“Œ Command Summary

Mode Shift Required Description encrypt Yes Encrypt plaintext decrypt Yes Decrypt ciphertext bruteforce No Try all shifts bruteforce --auto No Auto-detect plaintext

##πŸ§ͺ Example Encrypted text:

objectivec Copy code WKLV LV D VHFUHW PHVVDJH Output:

[+] Shift 3 β†’ THIS IS A SECRET MESSAGE

🧠 How It Works

Caesar cipher shifts characters within the alphabet

Brute-force tests all 26 keys

English scoring ranks results using word and space frequency

πŸ“ Project Structure

Caesar-Cipher-Tool/ β”œβ”€β”€ CS.py β”œβ”€β”€ encrypted.txt └── README.md

⚠️ Disclaimer

This project is for educational purposes only. Do not use Caesar cipher for real-world security.

πŸ‘€ Author

Om Jadhav Computer Engineering Student Cybersecurity Enthusiast

⭐ Support

If you found this useful, give the repository a ⭐

About

πŸ” A Linux-based Python command-line tool for implementing Caesar cipher encryption and decryption, performing brute-force attacks, and identifying correct plaintext through automatic English detection.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages