Table of contents

• Overview
• Screenshots
• Features
• Requirements
• Installing dependencies
• Getting started
• Device setup tutorial
• Compatibility
• Installing tools manually
• Disclaimer
• Developer
• Support

Overview

Own the device. Every way that matters.

Connect over USB or Wi‑Fi, then control the device, extract data, stream camera and microphone, manage apps, and automate a full Metasploit compromise, all from one menu.

You no longer need to memorize commands and arguments, PhoneSploit Pro does it for you. Pick a number and run.

Screenshots

Features

Requirements

• python3 — Python 3.10 or newer
• pip — Package installer for Python
• adb — Android Debug Bridge (ADB) from Android SDK Platform Tools
• metasploit-framework — Metasploit-Framework (msfvenom and msfconsole)
• scrcpy — scrcpy
• nmap — Nmap

Installing dependencies

Use the bundled installer to set up all dependencies automatically. It detects your OS and uses the appropriate package manager.

Linux / macOS / Termux

chmod +x install.sh
./install.sh

To install specific tools only: ./install.sh --components adb,nmap,pip
For per-component prompts: ./install.sh --interactive

Windows

Run PowerShell as Administrator, then:

Set-ExecutionPolicy -Scope Process Bypass
.\install.ps1

To install specific tools only: .\install.ps1 -Components adb,nmap,pip
For per-component prompts: .\install.ps1 -Interactive

From PhoneSploit Pro

If a dependency is missing, the program shows a Missing Dependencies warning. Press I to run the installer, Y to continue anyway, or N to exit.

Getting started

[!IMPORTANT] PhoneSploit Pro requires Python version 3.10 or higher. Please update Python before running the program.

Linux and macOS

Make sure all required software is installed.

git clone https://github.com/AzeemIdrisi/PhoneSploit-Pro.git
cd PhoneSploit-Pro/

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

python3 phonesploitpro.py

[!TIP] You only need to activate the virtual environment (source .venv/bin/activate) each time you open a new terminal before running the program.

Windows

Make sure all required software is installed.

git clone https://github.com/AzeemIdrisi/PhoneSploit-Pro.git
cd PhoneSploit-Pro/

python -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt

1. Download and extract the latest platform-tools from here.

2. Copy all files from the extracted platform-tools or adb directory into the PhoneSploit-Pro directory, then run:

python phonesploitpro.py

Device setup tutorial

Setting up an Android phone for the first time

• Enabling Developer Options

1. Open Settings.
2. Go to About Phone.
3. Find Build Number.
4. Tap Build Number seven times.
5. Enter your pattern, PIN, or password to enable the Developer options menu.
6. The Developer options menu will now appear in your Settings menu.

• Enabling USB debugging

1. Open Settings.
2. Go to System > Developer options.
3. Scroll down and enable USB debugging.

• Connecting with a computer

1. Connect your Android device and the adb host computer to the same Wi‑Fi network.
2. Connect the device to the host computer with a USB cable.
3. Open a terminal on the computer and run the following command:

adb devices

4. A pop-up will appear on the Android phone when you connect to a new PC for the first time: Allow USB debugging?.
5. Select Always allow from this computer, then tap Allow.
6. Then, in the terminal, run the following command:

adb tcpip 5555

7. You can now connect the Android phone to the computer over Wi‑Fi using adb.
8. Disconnect the USB cable.
9. Go to Settings > About Phone > Status > IP address and note the phone’s IP address.
10. Run PhoneSploit Pro, choose Connect a device, and enter the target’s IP address to connect over Wi‑Fi.

Connecting the Android phone the next time

1. Connect your Android device and host computer to the same Wi‑Fi network.
2. Run PhoneSploit Pro, choose Connect a device, and enter the target’s IP address to connect over Wi‑Fi.

Compatibility

This tool is tested on:

• ✅ Ubuntu
• ✅ Linux Mint
• ✅ Kali Linux
• ✅ Fedora
• ✅ Arch Linux
• ✅ Parrot Security OS
• ✅ Windows 11
• ✅ Termux (Android)

[!NOTE] New features are primarily tested on Linux, so Linux is recommended for running PhoneSploit Pro. Some features might not work properly on Windows.

Installing tools manually

If you prefer to install tools yourself, or the automatic installer is not available for your platform, use the sections below.

ADB

Linux

Open a terminal and run the following commands:

• Debian / Ubuntu

sudo apt update

sudo apt install adb

• Fedora

sudo dnf install android-tools

• Arch Linux / Manjaro

sudo pacman -Sy android-tools

For other Linux distributions, see: Android platform-tools downloads

macOS

Open a terminal and run the following command:

brew install android-platform-tools

Or download from: Android platform-tools downloads

Windows

Download from: Android platform-tools downloads

Termux

pkg update

pkg install android-tools

Metasploit-Framework

Linux and macOS

curl https://raw.githubusercontent.com/rapid7/metasploit-omnibus/master/config/templates/metasploit-framework-wrappers/msfupdate.erb > msfinstall && \
  chmod 755 msfinstall && \
  ./msfinstall

• macOS (Homebrew) — Metasploit is distributed as a Homebrew Cask (not brew install without --cask):

brew install --cask metasploit

Or follow: Installing Metasploit on Linux / macOS

Or visit: Metasploit download

Windows

Visit: Metasploit download

Or see: Windows: antivirus and installers

scrcpy

Visit the scrcpy GitHub page for the latest installation instructions: scrcpy — get the app

On Windows: Copy all files from the extracted scrcpy folder into the PhoneSploit-Pro folder.

[!IMPORTANT]
If scrcpy is not available for your Linux distribution (for example Kali Linux), you can install it manually (Linux guide) or build it in a few steps (Build guide).

Nmap

Linux

Open a terminal and run the following commands:

• Debian / Ubuntu

sudo apt update

sudo apt install nmap

• Fedora

sudo dnf install nmap

• Arch Linux / Manjaro

sudo pacman -Sy nmap

For other Linux distributions, see: Nmap download

macOS

Open a terminal and run the following command:

brew install nmap

Or visit: Nmap download

Windows

Download and install the latest stable release: Nmap for Windows

Termux

pkg update

pkg install nmap

Disclaimer

• This project and its developer do not promote any illegal activity and are not responsible for any misuse or damage caused by this project.
• This project is for educational purposes only.
• Please do not use this tool on other people’s devices without their permission.
• Do not use this tool to harm others.
• Use this project responsibly and only on your own devices or with explicit authorization.
• It is the end user’s responsibility to obey all applicable local, state, federal, and international laws.

Developer

Azeem Idrisi - @AzeemIdrisi

Support

If you like my work, you can support me via:

Copyright © 2026 Azeem Idrisi (github.com/AzeemIdrisi)