A powerful, multi-algorithm encryption and decryption desktop application with secure key management, built with PyQt6.

• Multiple Encryption Algorithms: Support for 9 different encryption algorithms
• Secure Key Storage: Keys are encrypted with AES-256-GCM using a master password
• Multi-language Support: Automatic detection of system language (English/French)
• Flexible Key Management: Store up to 50 keys per algorithm
• Multiple Output Formats: Base64 and Hexadecimal encoding support
• Cross-platform: Works on Windows, macOS, and Linux

• Installation
• Quick Start
• Supported Algorithms
• User Guide
  • Master Password
  • Key Management
  • Encryption
  • Decryption
• Security Architecture
• Technical Specifications
• Troubleshooting
• Contributing
• License

• Python 3.8 or higher
• pip (Python package manager)

pip install PyQt6 cryptography

python crypto_tool.py

Windows:

pythonw crypto_tool.py

Linux/macOS:

chmod +x crypto_tool.py
./crypto_tool.py

1. Launch the application - Run python crypto_tool.py
2. Create a master password - On first launch, you'll be prompted to create a master password (minimum 8 characters)
3. Generate a key - Go to "Key Management" tab, select an algorithm (e.g., AES-256), and click "Generate"
4. Encrypt text - Switch to "Encryption" tab, select your key, enter text, and click "Encrypt"
5. Copy the result - The encrypted text appears in Base64 or Hex format, ready to share

The master password protects all your encryption keys. It is used to derive a strong encryption key via PBKDF2-SHA256 with 600,000 iterations.

Important considerations:

• Minimum length: 8 characters
• Use a strong, unique password
• If you forget your master password, all keys are permanently lost
• The password is never stored; only a verification hash is kept

Changing your master password:

1. Go to "Key Management" tab
2. Click "Change password"
3. Enter your old password
4. Enter and confirm your new password

Generate a random key:

1. Select an algorithm from the list
2. Click "Generate"
3. Enter a descriptive name (e.g., "Work Backup 2024")
4. The key is automatically generated and saved

Import an existing key:

1. Select an algorithm
2. Click "Add"
3. Enter a name for the key
4. Paste the key in Base64 or Hex format (depending on current display setting)

• Rename: Select a key and click "Rename" or right-click → Rename
• Delete: Select a key and click "Delete" or right-click → Delete
• Copy: Right-click on a key → Copy (copies to clipboard)

• Maximum 50 keys per algorithm
• Keys are stored encrypted in system settings
• Key names must be unique within an algorithm

1. Go to the "Encryption" tab
2. Select the desired algorithm from the dropdown
3. Select the key to use
4. Choose output format (Base64 or Hex)
5. Enter or paste your plain text in the upper text area
6. Click "Encrypt"
7. The encrypted result appears in the lower text area

1. Go to the "Encryption" tab
2. Select the same algorithm used for encryption
3. Select the same key used for encryption
4. Set the format to match the encrypted text (Base64 or Hex)
5. Paste the encrypted text in the lower text area
6. Click "Decrypt"
7. The decrypted text appears in the upper text area

Common decryption errors:

• Wrong key selected
• Wrong algorithm selected
• Wrong format (Base64 vs Hex)
• Corrupted or truncated ciphertext

Master Password → PBKDF2-SHA256 (600,000 iterations) → 256-bit Master Key

Encryption Key + Random Salt → AES-256-GCM → Encrypted Key Blob

Components:

• Salt: 256 bits, randomly generated per installation
• IV/Nonce: 96 bits, randomly generated per encryption
• Authentication Tag: 128 bits, ensures integrity

Encrypted output structure:

[IV/Nonce][Ciphertext] → Base64 or Hex encoding

• OS: Windows 10+, macOS 10.14+, Linux (X11 or Wayland)
• Python: 3.8 or higher
• RAM: 50 MB minimum
• Disk: 10 MB for application + keys storage

• Ensure Caps Lock is off
• Try typing your password in a text editor first to verify
• If you've forgotten your password, you must delete the settings and start fresh (all keys will be lost)

Reset settings:

• Windows: Delete registry key HKEY_CURRENT_USER\Software\CryptoTool
• macOS: rm ~/Library/Preferences/com.cryptotool.plist
• Linux: rm ~/.config/CryptoTool/CryptoToolPro.conf

1. Verify you're using the exact same key
2. Verify you're using the exact same algorithm
3. Check that the format (Base64/Hex) matches
4. Ensure the ciphertext wasn't truncated or modified

1. Verify Python version: python --version (must be 3.8+)
2. Reinstall dependencies: pip install --upgrade PyQt6 cryptography
3. Check for error messages in terminal

1. Make sure the vault is unlocked (status bar should show "Vault unlocked" in green)
2. Select an algorithm from the list
3. If vault is locked, enter your master password to unlock

Currently, the application does not support command-line arguments. All operations are performed through the GUI.

pip install pyinstaller
pyinstaller --onefile --windowed --name "CryptoTool" crypto_tool.py

pip install py2app
python setup.py py2app

Use tools like appimage-builder or pyinstaller to create portable executables.

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/my-feature
3. Commit your changes: git commit -am 'Add new feature'
4. Push to the branch: git push origin feature/my-feature
5. Submit a Pull Request

• Follow PEP 8 guidelines
• Use type hints where possible
• Add docstrings to new functions and classes
• Update translations for new UI strings

1. Add a new entry to the TRANSLATIONS dictionary in crypto_tool.py
2. Copy all keys from the English ('en') translation
3. Translate all values to the target language
4. The language will be automatically detected based on system locale

• This software is provided as-is for educational and personal use
• Do not use weak algorithms (RC4, XOR) for sensitive data
• Backup your keys - if you lose your master password, keys cannot be recovered
• The application does not transmit any data - all operations are local
• Keys are stored encrypted but physical access to the machine could allow extraction

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

• PyQt6 - GUI framework
• cryptography - Cryptographic library
• Python - Programming language

• Initial release
• Support for 9 encryption algorithms
• Secure key storage with master password
• Multi-language support (English, French)
• Base64 and Hexadecimal encoding
• Up to 50 keys per algorithm

⚠️ Disclaimer: This software is provided for educational and personal use. The authors are not responsible for any misuse or data loss. Always backup important data and keys.