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.9.tar.gz (5.4 kB view details)

Uploaded Source

File details

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

File metadata

  • Download URL: apknife-1.0.9.tar.gz
  • Upload date:
  • Size: 5.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.9.tar.gz
Algorithm Hash digest
SHA256 977f114f99bb94d11a45d3754acd4329788ed1d06a983b41e3d73e22d7d87055
MD5 7e135967f1ffb53f7b14525e3bc49607
BLAKE2b-256 13292adf12081adb3c34d2e2bdb17417bf41863c0bd6608915cfa6c785b9410c

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