EncryptoCLI

📚 Description

EncryptoCLI is a powerful command-line tool for encryption, decryption, hashing, and steganography operations. It provides both an interactive TUI (Text User Interface) and a traditional CLI for flexible workflows.

Key Features

• Multiple Encryption Methods: AES (Fernet) and PGP/GPG support
• 13 Hash Algorithms: MD5, SHA256, SHA512, BLAKE2, BLAKE3, and more
• Image Steganography: Hide encrypted data in images using LSB or DCT methods
• Dual Interfaces: Interactive TUI or command-line arguments
• Modern Python: Built with Python 3.10+ type hints and async support

🚀 Installation

pip install EncryptoCLI

Requirements

• Python 3.10 or higher
• GPG (GNU Privacy Guard) for PGP encryption - Install GPG

💻 Usage

Interactive Mode (TUI)

Simply run without arguments to launch the interactive interface:

encryptocli

Command-Line Mode

Hashing

# Hash text
encryptocli hash --text "secret message" --algorithm SHA256

# Hash file
encryptocli hash --file document.pdf --algorithm SHA512

Supported Algorithms: MD5, SHA1, SHA224, SHA256, SHA384, SHA512, SHA3_224, SHA3_256, SHA3_384, SHA3_512, BLAKE2b, BLAKE2s, BLAKE3

AES Encryption

# Encrypt text
encryptocli encrypt --text "secret" --password "mypassword" --method aes

# Encrypt file
encryptocli encrypt --file document.txt --password "mypassword" --method aes

# Decrypt
encryptocli decrypt --file document.txt.enc --password "mypassword" --method aes

PGP Encryption

PGP encryption supports three ways to specify the recipient:

# Using recipient email (key from GPG keyring)
encryptocli encrypt --text "secret" --recipient-email "user@example.com" --method pgp

# Using public key file
encryptocli encrypt --text "secret" --recipient-key-file ~/recipient-pubkey.asc --method pgp

# Using inline public key
encryptocli encrypt --text "secret" --recipient-key "-----BEGIN PGP PUBLIC KEY BLOCK-----..." --method pgp

# Decrypt (requires your private key passphrase)
encryptocli decrypt --text "encrypted_data" --password "your_passphrase" --method pgp

Steganography

Hide encrypted data inside images:

# Encrypt and hide in image
encryptocli encrypt --text "secret" --password "pass" --image cover.png --steganography lsb

# Extract and decrypt from image
encryptocli decrypt --image cover.png --password "pass" --steganography lsb

Steganography Methods:

• lsb - Least Significant Bit (higher capacity)
• dct - Discrete Cosine Transform (more robust)

PGP Key Management

# List all keys
encryptocli pgp list

# Generate new key pair
encryptocli pgp generate --name "Your Name" --email "you@example.com"

# Import key from file
encryptocli pgp import --file pubkey.asc

# Export key
encryptocli pgp export --email "you@example.com" --output mykey.asc

🐳 Docker

Run EncryptoCLI in a container:

# Build image
docker build -t encryptocli .

# Run interactive mode
docker run -it encryptocli

# Run with command
docker run -it encryptocli encryptocli hash --text "hello" --algorithm SHA256

🛠️ Development

Setup

# Clone repository
git clone https://github.com/arpan-pandey/EncryptoCLI.git
cd EncryptoCLI

# Install dependencies
pip install -r requirements.txt

# Install in development mode
pip install -e .

Testing

# Run tests
pytest

# Run with coverage
pytest --cov=encryptocli

Code Quality

# Format code
black encryptocli/

# Type checking
mypy encryptocli/

# Linting
flake8 encryptocli/

📖 Documentation

Full documentation available at: https://arpan-pandey.github.io/EncryptoCLI/

🎥 Video Demo

Watch the EncryptoCLI Demo Video

📝 License

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

👤 Author

Arpan Pandey

• GitHub: @arpan-pandey

🤝 Contributing

Contributions, issues, and feature requests are welcome! See CONTRIBUTING.md for guidelines.

🐋 Docker

You can pull this image from Docker Hub and build it very easily.

1. Just pull the image.

   docker pull arpanpandey/encrypto:latest

OR

1. You can build the image using.

   docker build --pull --rm -f "Dockerfile" -t arpanpandey/encrypto:latest "."

2. Running the container with the image (Be sure to put the -t and -d flag.)

   docker run -t -d arpanpandey/encrypto:latest

License

This project is licensed under the MIT License.

Video Demo

You can access the video demo at https://youtu.be/Zmf2EK9jPCw

Contributors 🏆🏆

Thank You!

Thanks a lot to the team at CS50 for teaching me so much about the fascinating world of computer science and program.