README.md

PyDelta

Important note

This project will soon be achived. The original pypi package will soon be deleted but the repository will stay up as a public achive. Why? I made this project for fun a while ago and i just lost intrest in it, but non-related projects will come out soon. A big thanks to everyone that has contributed.

PyDelta is a Python obfuscator script designed to obfuscate Python source code, making it more difficult to understand and reverse-engineer. PyDelta obfuscates your scripts with multiple layers of protection making it extremely hard for someone to deobfuscate.

Features:

• Anti-Debugger: Adds anti-debugger code to the source to deter debugging attempts.
• Code Compression and Encryption: Compresses and encrypts the code to make it harder to analyze.
• String Encryption: Encrypts strings within the code to prevent easy extraction of sensitive information.
• Inline Imports: Converts imports to inline imports to reduce readability.
• Name Refactoring: Refactors variable, function and arguments identifiers to further obfuscate the code.

Usage:

PyDelta was intended to run in a browser but it is indeed possible to run it locally. Install PyDelta using the following pip command pip install pydeltaobfuscator.

Example Usage:

from pydelta import delta_obfuscate

source_code = """
# Your Python source code here
print('Hello')
"""

obfuscated_code = delta_obfuscate(source_code)
with open('my_obf_file.py', 'w') as file:
    file.write(obfuscated_code)

Or you can simply run the pydelta-obfuscate command.

Parameters:

• source_code: Source code to obfuscate
• add_anti_dbg: Whether to add anti-debugger code (default: True).
• inline_imports: Whether to convert imports to inline imports (default: True).
• refactor_names: Whether to refactor variable and function names (default: True).
• encrypt_str: Whether to encrypt strings in the code (default: True).
• compress_encrypt: Whether to compress and encrypt the entire code (default: True).
• str_encryption_amount: Number of times to encrypt strings (default: 3).
• compress_encrypt_amount: Number of times to compress and encrypt the code (default: 30).

CLI Arguments:

• no_add_anti_dbg
• no_inline_imports
• no_refactor_names
• no_encrypt_str
• no_compress_encrypt
• str_encryption_amount: Number of times to encrypt strings (default: 3).
• compress_encrypt_amount: Number of times to compress and encrypt the code (default: 30).

Notes

• This version of PyDelta is still in development and some features may not be fully functional.
• Python's __annotations__ attribute is broken and will be fixed in future releases. - Support added by therealOri
• Runtime code is obfuscated by choice which can make maintaining a little tricky, even if those function will likely remain untouched in future releases a module will be used.

License

This project is licensed under the MIT License.

Donating

MetaMask wallet address: 0x1E5a982BD1E54d3CD4EcD7A74642ed808783D506