https://github.com/giacomoferretti/paranoid-deobfuscator

Deobfuscate "paranoid" protected apps
https://github.com/giacomoferretti/paranoid-deobfuscator

android deobfuscation deobfuscator lsparanoid paranoid python python3 reverse-engineering static-analysis string-deobfuscator string-obfuscation string-obfuscator

Last synced: 21 days ago
JSON representation

Deobfuscate "paranoid" protected apps

• Host: GitHub
• URL: https://github.com/giacomoferretti/paranoid-deobfuscator
• Owner: giacomoferretti
• License: apache-2.0
• Created: 2020-09-04T15:20:30.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2025-03-26T20:56:35.000Z (about 1 month ago)
• Last Synced: 2025-03-30T02:04:03.334Z (28 days ago)
• Topics: android, deobfuscation, deobfuscator, lsparanoid, paranoid, python, python3, reverse-engineering, static-analysis, string-deobfuscator, string-obfuscation, string-obfuscator
• Language: Python
• Homepage:
• Size: 1.75 MB
• Stars: 56
• Watchers: 3
• Forks: 16
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
# Paranoid/LSParanoid deobfuscator

[![PyPI - Version](https://img.shields.io/pypi/v/paranoid-deobfuscator)](https://pypi.org/project/paranoid-deobfuscator)

> [!NOTE]

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

>

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

|            Before             |            After            |

| :---------------------------: | :-------------------------: |

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

## Installation

### Using pip

`pip install paranoid-deobfuscator`

### Using pipx

`pipx install paranoid-deobfuscator`

## Usage

```text

$ paranoid-deobfuscator --help

Usage: paranoid-deobfuscator [OPTIONS] COMMAND [ARGS]...

Options:

  -v, --verbose  Enables verbose mode

  --help         Show this message and exit.

Commands:

  deobfuscate  Deobfuscate a paranoid obfuscated APK smali files

  helpers      Helper commands

```

```text

$ paranoid-deobfuscator deobfuscate --help

Usage: paranoid-deobfuscator deobfuscate [OPTIONS] TARGET

  Deobfuscate a paranoid obfuscated APK smali files

Options:

  --help  Show this message and exit.

```

```text

$ paranoid-deobfuscator helpers --help

Usage: paranoid-deobfuscator helpers [OPTIONS] COMMAND [ARGS]...

  Helper commands

Options:

  --help  Show this message and exit.

Commands:

  deobfuscate-string  Deobfuscate a string using extracted chunks

  extract-chunks      Save the chunks from a paranoid obfuscated APK

  extract-strings     Extracts the strings from a paranoid obfuscated APK

```

### APK file (using [Apktool])

1. Decode `.apk` file: `apktool d app.apk`

2. Run deobfuscator: `paranoid-deobfuscator deobfuscate app` 

3. Build: `apktool b app`

### DEX file (using [smali])

1. Disassemble `.dex` file: `baksmali d classes.dex`

2. Run deobfuscator: `paranoid-deobfuscator deobfuscate out` 

3. Assemble: `smali a out`

[paranoid]: https://github.com/MichaelRocks/paranoid

[lsparanoid]: https://github.com/LSPosed/LSParanoid

[apktool]: https://github.com/iBotPeaches/Apktool

[smali]: https://github.com/google/smali

## 💖 Support My Work

If you find my projects useful, consider supporting me:

[![Donate on Liberapay](https://img.shields.io/badge/Liberapay-giacomoferretti-F6C915.svg?style=flat-square&logo=liberapay)](https://liberapay.com/giacomoferretti)

[![Support me on Ko-fi](https://img.shields.io/badge/Ko--fi-giacomoferretti-ff5f5f?style=flat-square&logo=ko-fi)](https://ko-fi.com/giacomoferretti)

[![Donate via PayPal](https://img.shields.io/badge/PayPal-hexile0-0070ba?style=flat-square&logo=paypal)](https://www.paypal.me/hexile0)

Your support helps me continue improving these tools and creating new ones. Thank you! 🙌

If you can't donate, I also appreciate **stars** ⭐ on my repositories!