Release v2.4

The AndroidSwiss ArmyKnife.

All-in-one remote Android testing from a single numbered menu. Connect over ADB, mirror with scrcpy, extract data, scan with Nmap, and drive Metasploit — without memorizing commands.

root@psp:~# git clone https://github.com/AzeemIdrisi/PhoneSploit-Pro.git
  • ADB
  • SCRCPY
  • NMAP
  • METASPLOIT
  • 82 FEATURES
6.4K+ starsGPL-3.0Python 3.10+Educational use

[ 01 / DEMOS ]

Watch it in action.

Step-by-step walkthroughs for connection, device control, and exploitation workflows.

DEMO_01 — PhoneSploit Pro — Device Exploitation Demo
DEMO_02 — PhoneSploit Pro — Control & Data Extraction Demo
DEMO_03 — PhoneSploit Pro — Overview

[ 02 / WORKFLOW ]

Connect. Control. Extract. Exploit.

Four phases, one menu — the same flow security researchers use from first ADB handshake to payload delivery.

01

Connect

Attach over USB or Wi-Fi ADB. List devices, pick a target, and manage the ADB server from the menu.

02

Control

Send keycodes, lock or unlock the screen, reboot modes, and mirror the display with scrcpy.

03

Extract

Pull SMS, contacts, call logs, WhatsApp data, photos, screenshots, and files without juggling shell one-liners.

04

Exploit

Run Nmap against the target and chain Metasploit payloads from the same interface when authorized testing calls for it.

[ 03 / FEATURES ]

82 commands. One menu.

Every capability from the README, indexed like the interactive menu — filter by category or browse the full list.

01

Connect a device

Connect to a device remotely using ADB.

02

List connected devices

Show all devices currently attached to ADB.

03

Disconnect all devices

Disconnect every ADB session.

04

Multi-device selection

If several ADB devices are connected, choose which device to use for the session.

05

Stop ADB server

Stop the ADB server process.

06

Restart ADB server

Restart the ADB server process.

07

Access device shell

Open an interactive shell on the connected device.

08

Keycodes

Send keycodes to control the device remotely.

09

Unlock device

Turn the screen on, swipe up, and enter a password when needed.

10

Lock device

Lock the device.

11

Restart / reboot

Restart or reboot the device to System, Recovery, Bootloader, or Fastboot.

12

Power off

Power off the target device.

[ 04 / INTERFACE ]

The Master Menu

Pick an option from the single-page interface — every feature maps to a menu entry you can run immediately.

phonesploitpro.py — session
PhoneSploit Pro main dashboard showing device connection and menu options

[ 05 / INSTALL ]

Get started in minutes.

Clone, virtualenv, pip install, run. Use install.sh or install.ps1 when you need ADB, scrcpy, Nmap, or Metasploit on PATH.

Linux / macOS

Full feature support — recommended host

Prerequisites

  • ›REQ: Python 3.10+
  • ›REQ: Git
  • ›REQ: ADB, scrcpy, Nmap, Metasploit (optional install.sh)

Run

01git clone https://github.com/AzeemIdrisi/PhoneSploit-Pro.git[COPY]
02cd PhoneSploit-Pro/[COPY]
03python3 -m venv .venv[COPY]
04source .venv/bin/activate[COPY]
05pip install -r requirements.txt[COPY]
06python3 phonesploitpro.py[COPY]

Dependencies (optional)

After clone, if ADB, scrcpy, Nmap, or Metasploit are missing.

07chmod +x install.sh[COPY]
08./install.sh[COPY]

README — device setup & troubleshooting

Getting started

Need help? Open an issue.

[ 06 / COMPATIBILITY ]

Runs on your host.

Linux and macOS are fully supported. Windows is experimental. Termux runs on-device.

PlatformStatus
Ubuntufull
Kali Linuxfull
Linux Mintfull
Fedorafull
Arch Linuxfull
Parrot OSfull
macOSfull
Windows 11partial
Termuxfull

Windows — partial support

scrcpy integration, some ADB operations, and Metasploit automation may require manual setup. New features are tested primarily on Linux. See the README for details.

[ 07 / FAQ ]

Common questions.

Legality, requirements, and setup — straight answers for researchers and students.

Yes. PhoneSploit Pro is open source under GPL-3.0. You can clone, use, and modify it according to the license terms.

[ READY ]

Ready to own the device?

Star the repo, report bugs, or join discussions. Use only on systems you are authorized to test.

Star the repo
GPL-3.0
Educational use only