https://github.com/bdr-pro/enigmalang

EnigmaLang 🕵️‍♂️💻🔒 is your digital armor, transforming Python scripts into undecipherable mysteries 🧙‍♂️✨. It weaves a spell of obfuscation and AES encryption, cloaking your code in secrecy. Imagine your script as a phoenix 🐦🔥, reborn from ashes into a form that eyes can't unravel. With a wand wave, EnigmaLang turns readable text to obfs
https://github.com/bdr-pro/enigmalang

Last synced: about 2 months ago
JSON representation

EnigmaLang 🕵️‍♂️💻🔒 is your digital armor, transforming Python scripts into undecipherable mysteries 🧙‍♂️✨. It weaves a spell of obfuscation and AES encryption, cloaking your code in secrecy. Imagine your script as a phoenix 🐦🔥, reborn from ashes into a form that eyes can't unravel. With a wand wave, EnigmaLang turns readable text to obfs

• Host: GitHub
• URL: https://github.com/bdr-pro/enigmalang
• Owner: BDR-Pro
• License: mit
• Created: 2024-04-01T22:23:15.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2024-04-15T22:48:06.000Z (9 months ago)
• Last Synced: 2024-04-15T23:56:45.334Z (9 months ago)
• Language: Python
• Homepage:
• Size: 12.8 MB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# EnigmaLang 🕵️‍♂️

## Overview

EnigmaLang offers a sophisticated way to protect your Python scripts through obfuscation and encryption, turning your code into an unreadable format before execution. This tool is particularly useful for distributing Python applications without revealing the source code, making it a valuable asset for software developers concerned with protecting their intellectual property.

## Features

- **Code Obfuscation:** Transforms your Python script into an obfuscated version, making it difficult to reverse-engineer.

- **AES Encryption:** Encrypts the obfuscated script for an additional layer of security.

- **Decryption Stub:** Automatically generates a stub to decrypt and execute the encrypted code seamlessly.

- **Executable Compilation:** Offers an option to compile the obfuscated script into a standalone executable.

## Installation

1. Ensure Python 3 is installed on your machine.

2. Clone or download the EnigmaLang repository to your local machine.

3. Navigate to the EnigmaLang directory and install the required dependencies:

   ```bash

   pip install -r requirements.txt

   ```

## Usage

To protect your Python script using EnigmaLang, follow these steps:

1. Place your Python script in the `test_code` directory of EnigmaLang.

2. Run the main EnigmaLang script, specifying your script name:

   ```bash

   python main.py test_code/yourscript.py   [--exe] [--sleep]

   ```

    - Replace `yourscript.py` with the name of your Python script.

    - `` is a secret word of your choosing that will be required to execute the encrypted script.

    - `` is the number of times the encryption process should be applied.

3. EnigmaLang will generate several files within the `test_code` directory:

   - An obfuscated version of your script.

   - A bytecode file containing the encrypted script.

   - A decryption stub in Python for decrypting and executing the encrypted script.

## Example

Suppose you have a simple Python script named `helloworld.py` with the following content:

```python

print("Hello World")

```

After running EnigmaLang, your `test_code` directory will contain:

- `helloworld_obfuscated.py`: The obfuscated version of `helloworld.py`.

- `helloworld_bytecode`: The encrypted bytecode of the obfuscated script.

- `helloworld_decryption_stub.py`: A Python script that, to debugging.

- `helloworld.py`: The original script (unchanged).

- `key.txt`: A file containing the secret 256 bit long to decrypt the code.

To execute the encrypted script, simply run the decryption stub:

```bash

python helloworld_obfuscated.py 

```

## Project Structure

```plaintext

EnigmaLang/

│

├── main.py

├── words_alpha.txt

├── requirements.txt

│

└── test_code/

    ├── helloworld_bytecode

    ├── helloworld_decryption_stub.py

    ├── helloworld_obfuscated.py

    └── helloworld.py

    └── key.txt    

```

## Contributing

We welcome contributions to improve EnigmaLang! Please feel free to submit pull requests or open issues to suggest features or report bugs.

## License

EnigmaLang is open-sourced under the MIT license. See the LICENSE file for more details.