Metadata-Version: 2.1
Name: paranoid-deobfuscator
Version: 2.0.0
Summary: Deobfuscate "paranoid" protected apps
Project-URL: Homepage, https://github.com/giacomoferretti/paranoid-deobfuscator
Project-URL: Bug Tracker, https://github.com/giacomoferretti/paranoid-deobfuscator/issues
Author-email: Giacomo Ferretti <giacomo.ferretti.00@gmail.com>
License-File: LICENSE
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Disassemblers
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.7
Requires-Dist: numpy>=1.26.0
Description-Content-Type: text/markdown

# Paranoid/LSParanoid deobfuscator

A script to deobfuscate apps obfuscated with [Paranoid]/[LSParanoid] to help you with static analysis.

NOTE: ⚠️ Currently not working on Windows. Please use WSL or a Linux VM. See [#14](https://github.com/giacomoferretti/paranoid-deobfuscator/issues/14).

NOTE: Only compatible with Paranoid v0.3.0+ (released in 25 Jan 2020)

|            Before             |            After            |
| :---------------------------: | :-------------------------: |
| ![Before](.assets/before.png) | ![After](.assets/after.png) |

## Installation

<!-- `pip install paranoid-deobfuscator` SOON -->

`python setup.py install`

## Requirements

- Python 3
  - `numpy` package (install it via `pip install numpy` or `pip install -r requirements.txt`)

## Usage

### APK file (using [Apktool])

1. Decode `.apk` file: `apktool d app.apk`
2. Run deobfuscator: `python -m paranoid_deobfuscator app` <!-- `paranoid-deobfuscator app` (or `python -m paranoid_deobfuscator app`) -->
3. Build: `apktool b app`
4. Enjoy your deobfuscated apk!

### DEX file (using [smali])

1. Disassemble `.dex` file: `baksmali d classes.dex`
2. Run deobfuscator: `python -m paranoid_deobfuscator out` <!-- `paranoid-deobfuscator out` (or `python -m paranoid_deobfuscator out`) -->
3. Assemble: `smali a out`
4. Enjoy your deobfuscated dex!

[paranoid]: https://github.com/MichaelRocks/paranoid
[lsparanoid]: https://github.com/LSPosed/LSParanoid
[apktool]: https://github.com/iBotPeaches/Apktool
[smali]: https://github.com/google/smali
