Skip to content

README.md

Latest commit

 

History

History
114 lines (82 loc) · 2.98 KB

README.md

File metadata and controls

114 lines (82 loc) · 2.98 KB

APK-Patchx

⚡ apk-patchx


🔥 What is apk-patchx?

apk-patchx is a command-line tool that makes APK manipulation fast, modular, and developer-friendly.
Whether you’re a security researcher, reverse engineer, or power user — it gives you a one-stop solution for:

  • 📦 Pulling & merging split APKs directly from connected Android devices
  • 🔍 Decoding & rebuilding APKs with apktool
  • 🧩 Injecting Frida gadgets into any architecture (arm, arm64, x86, x86_64)
  • 📝 Patching smali/dex code with your own hooks
  • 🔑 Auto-signing APKs for immediate deployment
  • 🎛️ Custom decode/build options for advanced workflows

apk-patchx Terminal Example

Installation

pip install apk-patchx

Usage

apk-patchx --help # For help regarding available commands
apk-patchx <COMMAND> --help # For help regarding options usage
apk-patchx patch --help # e.g.

Available Commands

Command Description
build Build APK from decoded directory.
decode Decode APK file.
patch Patch APK with Frida gadget.
pull Pull APK from connected device.
rename Rename APK package.
sign Sign APK file.

Patch Command (Full Options)

Options

Flag Description
-a, --arch [arm,arm64,x86,x86_64] Required. Target architecture.
-g, --gadget-conf PATH Custom Frida gadget config JSON file.
--net Add permissive network security config.
-s, --no-src Skip DEX disassembly.
--only-main-classes Only disassemble main DEX.
--frida-version TEXT Specify Frida version to use.
--apktool-decode-args TEXT Extra arguments for apktool decode.
--apktool-build-args TEXT Extra arguments for apktool build.
--help Show help and exit.

Rename APK package

apk-patchx rename app.apk com.newpackage.name

Sign APK

apk-patchx sign app.apk

Architecture Support

  • ARM (arm)
  • ARM64 (arm64)
  • x86 (x86)
  • x86_64 (x86_64)

Requirements

  • Python 3.8+
  • Java Runtime Environment (JRE 8+)
  • ADB (for device operations)

Tool Management

APK-Patchx automatically downloads and manages required tools in ~/.apk-patchx/tools/:

  • apktool
  • Android SDK build-tools
  • Platform tools (adb)
  • dexpatch
  • Frida gadgets

License

MIT License - see LICENSE file for details.