# CodingGay/BlackObfuscator

Black Obfuscator is an obfuscator for Android APK DexFile, it can help developer to protect source code by control flow flattening, and make it difficult to analyze the actual program control flow.

Repository: https://github.com/CodingGay/BlackObfuscator
Canonical: https://ross.abutalabs.com/products/blackobfuscator
Language: Java
License: Apache-2.0
License Family: permissive
Topics: android, dex, obfuscation, obfuscator, java, dex2jar, control-flow
Last push: 2025-05-03T04:02:48+00:00

## Health v2 (maintenance only)
Score: 31/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 19, release rhythm 8, longevity 100
- inputs: {"age_days": 1724, "days_push": 487, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1123, forks 238 (observed 2026-08-28T04:03:40.471634+00:00)

## What it is
BlackObfuscator is a Java-based obfuscator for Android DEX files that applies control flow flattening to make decompiled code hard to analyze. It is built on dex2jar and includes an Android Studio plugin and GUI tool for automated obfuscation during packaging.

## Use cases
- obfuscate android apk dex files
- protect android app source code from reverse engineering
- apply control flow flattening to dex bytecode
- make decompiled android code hard to read
- integrate dex obfuscation into android studio build
- obfuscate only specific packages of an android app

## When to choose
- you need DEX-level control flow obfuscation beyond ProGuard/R8 renaming
- you want to protect business logic in an Android APK from static analysis
- you need whitelist/blacklist rules to obfuscate only your own code

## When to avoid
- you only need identifier renaming or shrinking (use R8/ProGuard)
- you need runtime protections like anti-tampering or encryption
- your project is not Android/DEX based

## Facets
- artifact type: cli-tool
- maturity: active
- function: security, reverse-engineering, cli, developer-tools
- domain: security, android-tools, reverse-engineering, mobile-development
- platform: jvm, cli
- tags: obfuscator, dex, control-flow-flattening, apk-protection, android-studio-plugin, android

## Member repositories
- CodingGay/BlackObfuscator (main) score 31

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:40.471634+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:39:52.506965+00:00, confidence not recorded.
  - readme: https://github.com/CodingGay/BlackObfuscator (fetched 2026-08-28T04:03:40.471634+00:00, sha b76ec8e24f63)
- Data as of 2026-08-30T08:39:29.467469+00:00.