Skip to main content

APKnife is an advanced tool for APK analysis, modification, and security auditing. Whether you're a security researcher, penetration tester, or Android developer, APKnife provides powerful features for reverse engineering, decompiling, modifying, and analyzing APK files.

Project description

APKnife Cover

---

APKnife – The Double-Edged Blade of APK Analysis 🔪

Fear the Blade, Trust the Power!

APKnife is an advanced tool for APK analysis, modification, and security auditing. Whether you're a security researcher, penetration tester, or Android developer, APKnife provides powerful features for reverse engineering, decompiling, modifying, and analyzing APK files.


🚀 Features & Capabilities

✅ Extract & decompile APKs into readable formats ✅ Modify & repackage APKs effortlessly ✅ Analyze APKs for security vulnerabilities ✅ Edit AndroidManifest.xml & Smali code ✅ Extract Java source code from an APK ✅ Detect Remote Access Trojans (RATs) & malware ✅ Decode binary XML files & scan for API calls ✅ Change APK metadata (icon, name, package name) ✅ Identify security risks like excessive permissions ✅ Sign APKs for smooth installation


🔧 Installation

📌 Prerequisites

Ensure you have the following installed on your system:

Python 3.12

Java (JDK 8 or later)

apktool

zipalign

keytool

🛠 Setting Up a Python Virtual Environment

Before installing apknife, it's recommended to set up a Python virtual environment to avoid package conflicts.

1️⃣ Create a Python Virtual Environment:

python3 -m venv venv source venv/bin/activate # On Linux/macOS

venv\Scripts\activate # On Windows

2️⃣ Install Required Packages

Once the virtual environment is activated, install APKnife:

pip install apknife


📥 Installing Rust (Required for APKnife)

apknife requires Rust for building. Follow the installation steps based on your OS:

🐧 On Linux:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Then follow the on-screen instructions.

🍏 On macOS (Using Homebrew):

brew install rust

🖥️ On Windows:

  1. Visit rustup.rs and install Rust.

  2. Verify installation:

rustc --version

⚠️ Troubleshooting Common Issues

❌ Issue Installing Rust on Termux

Ensure Termux is up to date:

pkg update && pkg upgrade

Install required build tools:

pkg install clang make python rust

❌ Issues Installing APKnife

Rust not installed properly? Ensure it's correctly installed via rustup or your package manager.

Python conflicts? If there are issues with virtual environments, reset it:

rm -rf venv
python3 -m venv venv
source venv/bin/activate

✅ Verifying Installed Versions

python --version rustc --version


🌍 Setting Up Rust Environment Variables

🐧 On Linux/macOS

nano ~/.bashrc # For bash
nano ~/.zshrc   # For zsh

Add this line at the end:

export PATH="$HOME/.cargo/bin:$PATH"

Apply changes:

source ~/.bashrc  # For bash
source ~/.zshrc   # For zsh

🖥️ On Windows

  1. Open "Environment Variables" from the Start menu.

  2. Edit Path under System Variables and add:

C:\Users\<YourUsername>\.cargo\bin
  1. Click OK and restart your terminal.

Verify the setup:

cargo --version
rustc --version

📥 Cloning the Repository & Installing Dependencies

git clone https://github.com/elrashedy1992/APKnife.git
cd APKnife
pip install -r requirements.txt

📜 Usage

🖥️ Interactive Mode

To enter interactive mode, run:

python3 apknife.py interactive

This will launch a command-line interface for executing APKnife commands.


🛠️ Available Commands

🟢 Extract APK Contents

python3 apknife.py extract -i target.apk -o extracted/

🟢 Modify & Rebuild APK

python3 apknife.py build -i
extracted/ -o modified.apk

🟢 Sign APK

python3 apknife.py sign -i modified.apk

🟢 Analyze APK for Vulnerabilities

python3 apknife.py scan_vulnerabilities -i target.apk

🟢 Detect Remote Access Trojans (RATs)

python3 apknife.py catch_rat -i malicious.apk

🟢 Extract Java Source Code

python3 apknife.py extract-java -i target.apk -o src_folder

🟢 Change APK Name

python3 apknife.py modify-apk --name -i app.apk

🟢 Change APK Icon

python3 apknife.py modify-apk --icon new_icon.png -i app.apk

🟢 Modify Package Name

python3 apknife.py modify-apk --package com.example.example -i app.apk
python3 apknife.py modify-apk --name new_name --package new.package.name --icon anysize.any -o modified_apk.apk

🟢 Scan APK Permissions

python3 apknife.py scan_permissions -i target.apk

👇help menu👇


python3 apknife.py -h usage: apknife.py [-h] [-i INPUT] [-o OUTPUT] [-c] [--name NAME] [--icon ICON] [--package PACKAGE] {extract,build,sign,analyze,edit-manifest,smali,decode-xml,find-oncreate,find-api,scan-vulnerabilities,scan-permissions,catch_rat,extract-java,interactive,extract-sensitive,modify-apk}

APKnife: Advanced APK analysis & modification tool

positional arguments: {extract,build,sign,analyze,edit-manifest,smali,decode-xml,find-oncreate,find-api,scan-vulnerabilities,scan-permissions,catch_rat,extract-java,interactive,extract-sensitive,modify-apk} Command to execute

options: -h, --help show this help message and exit -i, --input INPUT Input APK file -o, --output OUTPUT Output file/directory -c, --compress Compress extracted Java files into a ZIP archive --name NAME New app name --icon ICON New app icon (resized automatically) --package PACKAGE New package name

⚠️ Legal Disclaimer

This tool is designed for educational and security research purposes only. Unauthorized use of APKnife on third-party applications without permission is illegal. The developers are not responsible for any misuse.


📜 License

APKnife is released under the MIT License – You are free to modify and distribute it for legal use.


💡 Contributions & Support

🚀 Contributions are welcome! Fork the repo, submit pull requests, and report issues. Let's make APKnife even better!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

apknife-1.0.7.tar.gz (20.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

apknife-1.0.7-py3-none-any.whl (25.2 kB view details)

Uploaded Python 3

File details

Details for the file apknife-1.0.7.tar.gz.

File metadata

  • Download URL: apknife-1.0.7.tar.gz
  • Upload date:
  • Size: 20.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for apknife-1.0.7.tar.gz
Algorithm Hash digest
SHA256 b60d38b9c242062097b9135f59449a4f75452a2aaa469bbb517dab0087a1fee9
MD5 be9989add02252d28dbed1c932c5aa17
BLAKE2b-256 5a867d05d359ae6f8312ef6fab891e916a40050d85280b241df6f43e1e9e54a2

See more details on using hashes here.

File details

Details for the file apknife-1.0.7-py3-none-any.whl.

File metadata

  • Download URL: apknife-1.0.7-py3-none-any.whl
  • Upload date:
  • Size: 25.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for apknife-1.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 eeee30494c0e703101ca8a415ff4d3e05ed5c41963a81d3a2423eddea6c8f704
MD5 b86fe6c9f4c9aa7273186da492d388b8
BLAKE2b-256 876e997a1b3f17bd37c2971d4513b17107a3966645f3794bb58c9c8df6584ec5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page