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.16.tar.gz (22.8 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.16-py3-none-any.whl (25.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: apknife-1.0.16.tar.gz
  • Upload date:
  • Size: 22.8 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.16.tar.gz
Algorithm Hash digest
SHA256 984c7850de0a7473b90f17a7850f6c002879826488ea98b492738aee9c302e88
MD5 5e084f56b63393416ada85450dc9caf4
BLAKE2b-256 a523fd894ae45d890a0d7228f4faa59961f6ae5dc3e25ee6c51ffe596448da09

See more details on using hashes here.

File details

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

File metadata

  • Download URL: apknife-1.0.16-py3-none-any.whl
  • Upload date:
  • Size: 25.7 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.16-py3-none-any.whl
Algorithm Hash digest
SHA256 b174c5322b366f5bc4316b5274bfc8b41d411dfdc1112a7ef59a446bb4d15d86
MD5 61f592bc37b2f25e486e7826645a4467
BLAKE2b-256 dad343ca4ec521979b1455095ccc5d6402ff24420f0fd52fc694e1f6b3bd5310

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