https://github.com/Hnfull/Intensio-Obfuscator
Obfuscate a python code 2.x and 3.x
https://github.com/Hnfull/Intensio-Obfuscator
obfuscated-code obfuscation python python3
Last synced: 10 months ago
JSON representation
Obfuscate a python code 2.x and 3.x
- Host: GitHub
- URL: https://github.com/Hnfull/Intensio-Obfuscator
- Owner: Hnfull
- License: mit
- Created: 2019-06-02T14:56:51.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-07-25T10:24:06.000Z (over 5 years ago)
- Last Synced: 2025-03-27T20:11:27.706Z (10 months ago)
- Topics: obfuscated-code, obfuscation, python, python3
- Language: Python
- Homepage:
- Size: 50.2 MB
- Stars: 634
- Watchers: 17
- Forks: 127
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Intensio-Obfuscator
# Project not maintained anymore
# Thanks to all contributors
[](https://pypi.python.org/pypi/intensio-obfuscator/)
## 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
```sh
$ 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
```sh
$ 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
- **Read these Documentations before to use Intensio-Obfuscator tool !**
- **Certain types of pattern are not supported**
- [Steps of usage](docs/steps_usage/python_steps_usage.md)
- [Required code format](docs/recommendations/python_code_recommendations.md)
- [Malfunctions](docs/malfunctions/python_code_malfunctions.md)
| 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
- [Python files obfuscated](docs/examples/python_code_examples.md)
## Todo
- Version 1.x.x-x:
- Code optimization
- Fix issues
- Improved features already present
- Add other functionalities
## License
- MIT
## Contact
- Hnfull **gitland@protonmail.com**
## 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