Android APK manipulation toolkit with Frida gadget injection support
Project description
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
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.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file apk_patchx-20.11.2025.0.tar.gz.
File metadata
- Download URL: apk_patchx-20.11.2025.0.tar.gz
- Upload date:
- Size: 18.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: python-requests/2.31.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9ac2fd913bbbd046e4617a42a09f1389ae15b59790413644d5fd76aa0bbd8bc6
|
|
| MD5 |
5d84cd3bf05a43769026add9a8a03c8d
|
|
| BLAKE2b-256 |
c8fc72b943f7a0e899c926de04f9636d8aca1a1ad79ab4929ce54f3e16a92a66
|
File details
Details for the file apk_patchx-20.11.2025.0-py3-none-any.whl.
File metadata
- Download URL: apk_patchx-20.11.2025.0-py3-none-any.whl
- Upload date:
- Size: 24.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: python-requests/2.31.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e5e989550fb0202772dacb06f8a024c568f4eb32f654272d93a5d86e59e0ae22
|
|
| MD5 |
d7a8d3bac00eb0c1d0069cca94419b91
|
|
| BLAKE2b-256 |
05f96f84a0d1db573c56be40c3219181022c300e1cb2406fc5bf6d2dca600c07
|
