/Intensio-Obfuscator

Obfuscate a python code 2.x and 3.x

Primary LanguagePythonMIT LicenseMIT

Intensio-Obfuscator

Project not maintained anymore

Thanks to all contributors

PyPI Version

What is this ?

  • Intensio-Obfsucator tool takes a python source code and transform it into an obfuscated python code
    • Replace all names of variables/classes/functions/files-name to random strings with length defined then all chars to their hexadecimal value
    • Delete all comments, all spaces lines
    • Padding random snippets code/functions/classes with an always differents values

What purpose ?

  • Provides a high level obfuscation layer to prevent or delay the reading and understanding of your python program

Level of obfuscation

  • Weak obfuscation if used alone, can be used with other types of obfuscation

Requirements

  • Python >= 3.5
  • requirements.txt

Files supported

  • Files written in python 2.x and 3.x

Installation

  • From source
$ git clone https://github.com/Hnfull/Intensio-Obfuscator.git
$ python3 -m pip install -r Intensio-Obfuscator/requirements.txt
$ cd Intensio-Obfuscator/src/intensio_obfuscator
$ python3 intensio_obfuscator.py --help
  • From python package
$ python3 -m pip install intensio-obfuscator
$ intensio_obfuscator --help

Features

Features Descriptions Purpose of obfuscation Compatibility with all types of python codes/syntaxes
Delete comments Delete all comments (this feature is executed by default) Delete potential behavioral informations high python files 2 & 3
Delete line spaces Delete all spaces line (this feature is executed by default) Reduce the code visibility in clear high python files 2 & 3
Correction padding empty classes/functions Add padding to empty classes and functions, if the class or function contains comments only, the default feature Delete comments can potentially let a class or function empty, this will avoid to generate an error (this feature is executed by default) None, only to avoid to generate errors high python files 2 & 3
Replace string to string mixed Replace all names of variables/classes/functions to random strings with length defined Reduce the code visibility in clear - Delay the deduction of the behavior of variables/classes/functions low - high (depends of number of names that must exclude or not) python files 2 & 3
Exclude words file to exclude word (check documentation for the format) only for 'replace file name' obfuscation feature Information not required Information not required
Padding script Add padding of random scripts after each line Reduce the code visibility in clear - add dead snippets code/classes/functions to blur and delay behavior analysis of program high python file 2 & 3
Replace files name Replace all files name to random strings with length defined Reduce the code visibility in clear - Reduce the deduction of functionnalities of files low python files 2 & 3
Exclude file names file to exclude file names (check documentation for the format) only for 'replace file name' obfuscation feature Information not required Information not required
Replace string to hex Replace all chars to their hexadecimal value Reduce the code visibility in clear / avoid to be detected by the 'grep' commands per example medium python files 2 only
Correction delete pyc file Delete all pyc file in output directory (this feature is executed by default) Delete files already compiled without having been obfuscated before high python files 2 & 3
Mixer length lower Define random strings length of 32 chars when -rts, --replacetostr or -ps, --paddingscripts or -rfn, --replacefilesname or -rth, --replacetohex parameters are specified The longer the length is used, the more difficult the visibility of the code Information not required
Mixer length medium Define random strings length of 64 chars when -rts, --replacetostr or -ps, --paddingscripts or -rfn, --replacefilesname or -rth, --replacetohex parameters are specified The longer the length is used, the more difficult the visibility of the code Information not required
Mixer length high Define random strings length of 128 chars when -rts, --replacetostr or -ps, --paddingscripts or -rfn, --replacefilesname or -rth, --replacetohex parameters are specified The longer the length is used, the more difficult the visibility of the code Information not required
  • Features can be executed separatly:
    • replace string to string mixed -> -rts, --replacetostr
    • padding script -> -ps, --paddingscript
    • replace file name -> -rfn, --replacefilename
    • replace string to hex -> -rth, --replacetohex

Usages

Parameters Descriptions
-h, --help show this help message and exit
-i, --input source directory - indicate a directory that contain your file
-o, --output output directory that will be obfuscated - indicate a empty directory that will contain your file
-mlen, --mixerlength define length of random strings generated [lower:32|medium:64|high:128] chars when --replacetostr or --paddingscripts or -rfn, --replacefilesname or --replacetohex features are specified, possible values: [lower|medium|high]
-ind, --indent indicate the indentation of your python source code, possible values: [2|4|8]
-rts, --replacetostr enable replace string to string mixed obfuscation feature
--excludewords file to exclude specific words (check documentation for the format) only for -rts, --replacetostr obfuscation feature
-ps, --paddingscript enable padding script obfuscation feature
-rfn, --replacefilename enable replace file name obfuscation feature
--excludefiles file to exclude file name (check documentation for the format) only for -rfn, --replacefilename obfuscation feature
-rth, --replacetohex enable replace string to hex obfuscation (python files 2 only)
--version check current version
-v, --verbose improve verbosity

Obfuscation examples

Todo

  • Version 1.x.x-x:
    • Code optimization
    • Fix issues
    • Improved features already present
    • Add other functionalities

License

  • MIT

Contact

Disclamer

  • Intensio-Obfuscator is for education/research purposes only. The author takes NO responsibility ay for how you choose to use any of the tools provided