Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hostileninja72/encryption-tool
A tool used to encrypt using different algorithms.
https://github.com/hostileninja72/encryption-tool
Last synced: 1 day ago
JSON representation
A tool used to encrypt using different algorithms.
- Host: GitHub
- URL: https://github.com/hostileninja72/encryption-tool
- Owner: HostileNinja72
- Created: 2024-01-21T22:43:33.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-08-24T17:39:43.000Z (3 months ago)
- Last Synced: 2024-08-24T19:02:28.606Z (3 months ago)
- Language: Python
- Size: 1.97 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: history/his.log
Awesome Lists containing this project
README
# README for Cryptographic Tool
## Overview
This tool is designed to provide robust cryptographic functionalities, including AES, ChaCha20, and RSA algorithms. It allows users to perform encryption and decryption on various types of data, including text and files, through a command-line interface.
## Features
- Support for AES (with modes ECB, CBC, CTR, GCM), ChaCha20, and RSA algorithms.
- Encryption and decryption capabilities for both textual data and files.
- Secure key, nonce, and IV handling for different cryptographic modes.
## Requirements
- Python environment (Preferably Python 3.6 or higher)
- Required Python libraries: `secrets`, `hashlib`, `mimetypes`, `json`, `logging`, `tqdm`
- Operating System: Windows, Linux, or macOS
## Installation
1. Clone the repository or download the source code.
2. Ensure Python is installed on your system.
3. Navigate to the tool's directory and run the Python script.
```bash
python main.py [arguments]
```
## Usage
The tool is executed via command-line interface. Below are the available commands and options:
```
python main.py -a [ALGORITHM] -M [MODE] -p [FILE_PATH] -m [MESSAGE] -k [KEY] -n [NONCE] -iv [IV] -j [JSON_PATH] -d
```
- `-a`, `-algorithm`: Choose between `AES`, `RSA`, `ChaCha20`
- `-M`, `-mode`: Select mode (only for AES) - `CTR`, `GCM`, `CBC`, `ECB`
- `-d`, `-decryption`: Use this flag to perform decryption
- `-k`, `-key`: Path to the key file or the key's numerical value (for decryption)
- `-n`, `-nonce`: Specify nonce value (for decryption in AES CTR)
- `-iv`: Specify IV (Initialization Vector) value (for decryption in AES CBC)
- `-j`: Specify the json file generated during encryption (for decryption)
- `-p`, `-path`: Specify the file path for file encryption/decryption
- `-m`, `-message`: Specify the message for direct text encryption/decryption
## Examples
Encrypt a file using AES in CBC mode:
```bash
python main.py -a AES -M CBC -p path/to/file
```
## Logging
- Logs are stored in the `history` directory, which is automatically created.
- Log files provide a record of operations, errors, and other important information.