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.
1 maintainer
Release files for apk-patchx 22.11.2025.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| apk_patchx-22.11.2025.1.tar.gz | 17.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| apk_patchx-22.11.2025.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 41.8 kB
Release files / apk_patchx-22.11.2025.1.tar.gz
| Download URL | apk_patchx-22.11.2025.1.tar.gz |
|---|---|
| Size | 17.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
10c0bd5caab8281785d153828ce166ecb8d9068e1823b896e1a72238d4655523
|
|
BLAKE2b-256 checksum How to use checksums |
4dd38bea227cff6bccab880636750666367c6fa70f91cb9f786864e3b72ff69b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-requests/2.31.0
|
Release files / apk_patchx-22.11.2025.1-py3-none-any.whl
| Download URL | apk_patchx-22.11.2025.1-py3-none-any.whl |
|---|---|
| Size | 23.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6ffa58d0a0c3f5b5ee755ccd3876a11949e12b911faa426e95efd8f3607e68e1
|
|
BLAKE2b-256 checksum How to use checksums |
7e3db00af05ae4236dbab0cb960fc4009c480e582f150ff6fbb90ad98d30e359
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-requests/2.31.0
|
