DualKey - Encryption/Decryption Tool

DualKey is a simple command-line tool for encrypting and decrypting sensitive text using a user-defined encryption key and offset.

---

Features

• ✅ Encrypts text using a custom encryption key and offset
• ✅ Decrypts encrypted text back to its original form
• ✅ Simple command-line interface with input validation
• ✅ ANSI color formatting for better readability
• ✅ Cross-platform support (Linux, macOS, Windows)

---

Installation

Using Python (Recommended)

Ensure you have Python 3.11+ installed, then install the tool using pip:

pip install dualkey

Using Homebrew

brew install dualkey

Usage

1. Running the tool After installation, run the following command:

dualkey

You will be prompted to enter an encryption key and offset.

1. Encryption Example

Enter encryption key (4-digit number): 1234
Enter offset value (4 to 6 digit number): 56789
Do you want to (E)ncrypt or (D)ecrypt? e
Enter text to encrypt (max 300 characters): hello world

Output:

Encrypted Text: 71547 67845 76483 76483 80185 -17301 90057 80185 83887 76483 66611

2. Decryption Example

Enter encryption key (4-digit number): 1234
Enter offset value (4 to 6 digit number): 56789
Do you want to (E)ncrypt or (D)ecrypt? d
Enter the encrypted text to decrypt: 71547 67845 76483 76483 80185 -17301 90057 

Output:

Decrypted Text: hello world

3. How It Works

The tool uses a simple formula to encrypt each character of the input:

Encrypted character = (ASCII value * key) - offset

To decrypt, it reverses the formula:

Original ASCII = (Encrypted value + offset) // key

Example Use Cases

• Higher security when sending or storing sensitive content digitally
• Encrypting personal notes
• Quick encryption for sensitive data on the go
• Security Notice

⚠ This tool does not provide cryptographic security. It is a simple educational utility and should not be used for high-security applications. Always rely on industry-standard encryption methods for sensitive data.

Development

Clone the repository

git clone https://github.com/ilovespectra/dual.key.git
cd dualkey

Install dependencies

pip install -r requirements.txt

Run the tool locally

python dualkey.py

Contributing

Contributions are welcome! To contribute:

• Fork the repository
• Create a feature branch (git checkout -b feature-name)
• Commit your changes (git commit -m 'Add feature')
• Push to your branch (git push origin feature-name)
• Create a Pull Request

License

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

Contact

For questions, suggestions, or issues, feel free to open an issue on GitHub or reach out via email:

📧 denverhnt@gmail.com
🐙 GitHub: @ilovespectra