v2.0

This release refactors the monolithic entry point into a modular package, adds configurable resolution of external tools (ADB, Metasploit, scrcpy, Nmap), Rich-based console UX (tables, panels, spinners, themed messages), Nmap-driven LAN scanning via python-nmap with ADB-oriented summaries, new ADB-focused features (port forwarding, WiFi utilities, root heuristics, app lifecycle, permissions, split APKs, logcat, etc.), expands the menu to five pages (62 numbered actions + update), bumps the project to v2.0, updates dependencies, and rewrites the README with a table of contents and refreshed screenshots.

---

Commits (oldest → newest)

Commit	Description
ba43278	feat: Refactor code into modules for readability and maintainability.
457c97d	Improve console prompts, task status, file management; readability refactors.
d703aa8	ADB/tool handling: resolve paths for ADB, Metasploit, scrcpy, Nmap; startup checks.
20b1ac7	New modules: port forwarding, root checks, WiFi utilities; menu updates.
60d6a92	Menu structure and paging; clearer prompts; comment cleanup.
65bc2c1	ADB port scanning/sorting; Nmap-based network scan; host summaries and hints.
ab32c6d	README: structure, TOC, features list, screenshots.

---

Architecture & code organization

• phonesploitpro.py is a thin launcher that calls modules.cli.run().
• New modules/ layout: cli.py (startup, menus, dispatch), config.py (AppConfig with resolved tool paths), tools.py (PATH / Windows-local resolution), console.py (Rich UI helpers, ADB subprocess helpers), banner.py (v2.0, five-page menus), connection.py (connect/disconnect, list devices, Nmap scan), plus focused modules for device, files, media, apps, WiFi, root, security, extras, port forwarding, etc.
• modules/release.py removed as part of the refactor.
• .gitignore: adds .cursor/.

---

Feature & behavior additions (high level)

Tooling & startup

• resolve_external_tools() fills adb_path, msfvenom_path, msfconsole_path, scrcpy_path, nmap_path on AppConfig.
• check_packages() lists missing tools in a Rich Panel and allows optional continue (Y/N).
• set_adb_executable() so ADB calls use the resolved binary consistently.

Network scanning

• python-nmap drives the system Nmap binary (with optional nmap_search_path matching startup resolution).
• Host discovery on local /24, then targeted scan of 5554/5555 with TCP connect and light -sV probing; IPv4 hosts sorted; per-host ADB line and “Android?” hint derived from parsed results—not raw Nmap dump.
• PortScannerError handled so failures return to the menu flow cleanly.

Menu expansion

• 5 pages of numbered actions through 61, plus 62 (update). New/expanded areas include TCP port forward / reverse, WiFi (status, dumps, toggle, ping, saved networks, etc.), root heuristics, split APKs, developer settings, locale, screen stay-on, permissions, logcat (snippet + live), app lifecycle (restart, force-stop, clear data), network snapshot, and more—alongside existing connect, shell, media, and Metasploit flows. Full list lives in modules/banner.py.

User experience (non-library)

• Downloaded-Files created at startup; multi-device sessions can pick a default serial when several devices are connected.

---

Dependencies & how they improve UX

rich (rich>=14.0.0)

• Console + Theme — Semantic styles (info, success, warning, error, prompt, etc.) so messages are consistent and scannable.
• console.status(..., spinner="dots") (task_status) — Long operations (ADB restart/connect, device fetch, network discovery, port probe, root checks) show a spinner line that updates in place instead of a silent hang.
• Table — Structured output for connected devices, network scan results (IP, ADB ports, Android hint), multi-device picker, root/build heuristics, and similar flows in WiFi, apps, files, and extras—replacing hard-to-read raw command output.
• Panel — Bordered blocks for missing dependencies at startup and the root assessment verdict after heuristics.
• Styled console.input — Clear prompts for paths, IPs, and Y/N confirmations.

Overall, Rich turns CLI output into tables, panels, and progress feedback appropriate for a menu-driven tool.

python-nmap (python-nmap==0.7.1)

• Binds the system nmap executable (still required; PyPI package does not replace installing Nmap). Uses the same resolved path as config.nmap_path when set.
• Orchestrates discovery + ADB-port scans from Python, parses results, and feeds them into Rich tables with summaries and hints—better UX than pasting full Nmap text.

---

Full Changelog: v1.61...v2.0

v1.61

What's New

This update makes PhoneSploit Pro more smart. There are improvements in the new features introduced in the last release.

Now it will detect Android Version before Streaming/Recording audio from the target device as this feature is only supported by devices running on Android 11 or above. If any device does not meet this requirement the program control goes back to main menu instead of crashing.

By @AzeemIdrisi

Full Changelog: v1.6...v1.61

v1.6

What's New

This update makes PhoneSploit Pro more functional.

Introduced 4 new options

1. Listen Microphone Audio

• Directly stream the target device's microphone audio.

2. Record Microphone Audio

• Stream and record the target device's microphone audio.

3. Listen Device Audio

• Directly stream the target device's media audio.

2. Record Device Audio

• Stream and record the target device's media audio.

Feature Request #30 Completed.
By @AzeemIdrisi
Full Changelog: v1.52...v1.6

v1.52

What's New

This update makes PhoneSploit Pro more smarter.

Improvements in 3 options

1. List Installed Apps

• The output of installed apps is now more clean and displays the index as well which makes it easier to count the number of apps installed.

2. Extract APK

• Now you can select an app from Installed apps list instead of typing the package name manually however manual mode is still available as second option.
• If the APK is already extracted earlier at the same location then the program will notify you instead of crashing.
• If invalid package name is provided in manual mode then the program will notify you instead of crashing.

3. Run an App

• Now you can select an app from Installed apps list instead of typing the package name manually however manual mode is still available as second option.

Full Changelog: v1.51...v1.52
By - @AzeemIdrisi

v1.51

What's New

(Improvement) Option - Uninstall an app : Now you have the option to select an App from the installed apps list to easily uninstall packages from the target device instead of typing the full package name. However if you want to uninstall some specific package that is not available in the list, then the option is still there to type package name manually.

This update makes Uninstalling an application faster and easier.

By @AzeemIdrisi
Full Changelog: v1.5...v1.51

v1.5

This version v1.5 of PhoneSploit Pro contains all the main features, The main focus for this version was to make the program able to scan for hosts i.e. list all the devices connected to the network so that it is easy to get target IP Address without physically touching the target device. This feature requires Nmap to work hence it should be installed in your system.

Changes in this version:

Added an option to Scan the local network for hosts and list the IP address with name of all devices connected to the network.

This release is ready to use and contains a lot of functions. Tested on Linux and Windows. All features upto v1.5 can be found here.

Full Changelog: v1.43...v1.5

v1.43

Improvements

Fixed : Do you want to open this file ? for macOS

Now you can directly view downloaded media like screenshots, screen-recording videos etc. on macOS as well.

This release has all main features and is ready to use.
Full Changelog: v1.42...v1.43
@AzeemIdrisi

v1.42

Changes:

1. Added an option to update PhoneSploit-Pro to the latest version directly from the program.
2. Added an option to visit the project's GitHub page directly.

By @AzeemIdrisi
Full Changelog: v1.41...v1.42

v1.41

Added disabling app verification before the installation of payload apk file in Option 15. This change makes the hacking process much faster. Also this change was necessary because the new Google Play Protect UI was not letting keycodes work to bypass it.

In v1.41, PhoneSploit Pro automatically disables app verification over ADB and then restore it to previous state after the hacking process is done.

Also, if the payload apk is already installed in the target device, then first it will be uninstalled and then the new payload apk will be installed.

By @AzeemIdrisi
Full Changelog: v1.4...v1.41

v1.4

This version v1.4 of PhoneSploit Pro contains all the main features, The main focus for this version was to make the program smarter and improve the user experience and fix bugs.

Changes in this version:

• ADB server restarts everytime on a new connection so that only 1 device is connected to ADB.
• Added modes to Mirroring option
• Now it checks if file exist on location before push and pull operations.
• Checks if IP address is valid or not.
• Added the missing power off option

Formatted output, Improved code, Made program intelligent, Bug fixes and overall user experience improvement
This release is ready to use and contains a lot of functions. Tested on Linux and Windows. All features upto v1.4 can be found here.

What's Changed

• Screenshot correction by @AzeemIdrisi in #26

Full Changelog: v1.3...v1.4