{"id":13510783,"url":"https://github.com/AzeemIdrisi/PhoneSploit-Pro","last_synced_at":"2025-03-30T17:31:22.553Z","repository":{"id":65404995,"uuid":"581884183","full_name":"AzeemIdrisi/PhoneSploit-Pro","owner":"AzeemIdrisi","description":"An all-in-one hacking tool to remotely exploit Android devices using ADB and Metasploit-Framework to get a Meterpreter session.","archived":false,"fork":false,"pushed_at":"2024-04-19T16:34:31.000Z","size":3148,"stargazers_count":5031,"open_issues_count":1,"forks_count":672,"subscribers_count":110,"default_branch":"main","last_synced_at":"2025-03-26T07:08:00.116Z","etag":null,"topics":["adb","android","android-debug-bridge","android-hacking","collaborate","cybersecurity","exploit","hack","hacking","hacking-script","hacking-tool","hacktoberfest","metasploit-framework","meterpreter","penetration-testing","pentest-tool","pentesting","phonesploit","phonesploit-pro","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AzeemIdrisi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"docs/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"AzeemIdrisi","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2022-12-24T18:05:33.000Z","updated_at":"2025-03-26T04:52:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"8979f638-afc3-46f1-92b7-cda81c3f5a8e","html_url":"https://github.com/AzeemIdrisi/PhoneSploit-Pro","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzeemIdrisi%2FPhoneSploit-Pro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzeemIdrisi%2FPhoneSploit-Pro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzeemIdrisi%2FPhoneSploit-Pro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzeemIdrisi%2FPhoneSploit-Pro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AzeemIdrisi","download_url":"https://codeload.github.com/AzeemIdrisi/PhoneSploit-Pro/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246355383,"owners_count":20763990,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adb","android","android-debug-bridge","android-hacking","collaborate","cybersecurity","exploit","hack","hacking","hacking-script","hacking-tool","hacktoberfest","metasploit-framework","meterpreter","penetration-testing","pentest-tool","pentesting","phonesploit","phonesploit-pro","python"],"created_at":"2024-08-01T02:01:53.867Z","updated_at":"2025-03-30T17:31:22.548Z","avatar_url":"https://github.com/AzeemIdrisi.png","language":"Python","readme":"\u003cdiv align=\"center\"\u003e\n  \n# PhoneSploit Pro\n  \n### PhoneSploit with Metasploit Integration.\n\nAn all-in-one hacking tool written in `Python` to remotely exploit Android devices using `ADB` (Android Debug Bridge) and `Metasploit-Framework`.\n\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/AzeemIdrisi/PhoneSploit-Pro)\n![Python](https://img.shields.io/badge/python-v3.10%2B-blue)\n![GitHub Release Date](https://img.shields.io/github/release-date/AzeemIdrisi/PhoneSploit-Pro?logo=github)\n![GitHub last commit](https://img.shields.io/github/last-commit/AzeemIdrisi/PhoneSploit-Pro?logo=github)\n![GitHub Repo stars](https://img.shields.io/github/stars/AzeemIdrisi/PhoneSploit-Pro?style=social)\n![GitHub forks](https://img.shields.io/github/forks/AzeemIdrisi/PhoneSploit-Pro?style=social)\n\n\u003c/div\u003e\n\n#### Complete Automation to get a Meterpreter session in One Click\n\nThis tool can automatically __Create__, __Install__, and __Run__ payload on the target device using __Metasploit-Framework__ and __ADB__ to completely hack the Android Device in one click if the device has open ADB port `TCP 5555`.\n\nThe goal of this project is to make penetration testing and vulnerability assessment on Android devices easy. Now you don't have to learn commands and arguments, PhoneSploit Pro does it for you. Using this tool, you can test the security of your Android devices easily.\n\n\u003e [!TIP]\n\u003e __PhoneSploit Pro__ can also be used as a complete ADB Toolkit to perform various operations on Android devices over Wi-Fi as well as USB. \n\n# Screenshots\n\n![Screenshot Page 1](docs/Screenshot-1.png)\n![Screenshot Page 2](docs/Screenshot-2.png)\n![Screenshot Page 3](docs/Screenshot-3.png)\n\n# Features \n## v1.0\n\n* Connect device using ADB remotely.\n* List connected devices.\n* Disconnect all devices.\n* Access connected device shell.\n* Stop ADB Server.\n* Take screenshot and pull it to computer automatically.\n* Screen Record target device screen for a specified time and automatically pull it to computer.\n* Download file/folder from target device.\n* Send file/folder from computer to target device.\n* Run an app.\n* Install an APK file from computer to target device.\n* Uninstall an app.\n* List all installed apps in target device.\n* Restart/Reboot the target device to `System`, `Recovery`, `Bootloader`, `Fastboot`.\n* __Hack Device Completely__ : \n  - Automatically fetch your `IP Address` to set `LHOST`.\n  - Automatically create a payload using `msfvenom`, install it, and run it on target device.\n  - Then automatically launch and setup __Metasploit-Framework__ to get a `meterpreter` session.\n  - Getting a `meterpreter` session means the device is completely hacked using Metasploit-Framework, and you can do anything with it.\n\n\n## v1.1\n\n* List all files and folders of the target devices.\n* Copy all WhatsApp Data to computer.\n* Copy all Screenshots to computer.\n* Copy all Camera Photos to computer.\n* Take screenshots and screen-record anonymously (Automatically delete file from target device).\n* Open a link on target device.\n* Display an image/photo on target device.\n* Play an audio on target device.\n* Play a video on target device.\n* Get device information.\n* Get battery information.\n* Use Keycodes to control device remotely.\n\n\n## v1.2\n\n* Send SMS through target device.\n* Unlock device (Automatic screen on, swipe up and password input).\n* Lock device.\n* Dump all SMS from device to computer.\n* Dump all Contacts from device to computer.\n* Dump all Call Logs from device to computer.\n* Extract APK from an installed app.\n\n## v1.3\n\n* Mirror and Control the target device. \n\n## v1.4\n\n* Power off the target device. \n\n## v1.5\n\n* Scan local network for connected devices to get Target IP Address. \n\n## v1.6\n\n* Record Microphone Audio\n* Stream Microphone Audio\n* Record Device Audio\n* Stream Device Audio\n\n# Requirements  \n* [`python3`](https://www.python.org/) : Python 3.10 or Newer\n* [`pip`](https://pip.pypa.io/en/stable/installation/) : Package installer for Python\n* [`adb`](https://developer.android.com/studio/command-line/adb) : Android Debug Bridge (ADB) from `Android SDK Platform Tools`\n* [`metasploit-framework`](https://www.metasploit.com/) : Metasploit-Framework (`msfvenom` and `msfconsole`)\n* [`scrcpy`](https://github.com/Genymobile/scrcpy) : Scrcpy\n* [`nmap`](https://nmap.org/) : Nmap\n\n\n# Run PhoneSploit Pro \n\n__PhoneSploit Pro__ does not need any installation and runs directly using `python3`\n\n\u003e [!IMPORTANT]\n\u003e **PhoneSploit Pro** requires Python version __3.10 or higher__. Please update Python before running the program.\n\n#### On Linux / macOS :\n\nMake sure all the [required](https://github.com/AzeemIdrisi/PhoneSploit-Pro#requirements) software are installed.\n\nOpen terminal and paste the following commands : \n```\ngit clone https://github.com/AzeemIdrisi/PhoneSploit-Pro.git\n```\n```\ncd PhoneSploit-Pro/\n```\n```\npip install -r requirements.txt\n```\n```\npython3 phonesploitpro.py\n```\n#### On Windows :\n\nMake sure all the [required](https://github.com/AzeemIdrisi/PhoneSploit-Pro#requirements) software are installed.\n\n\nOpen terminal and paste the following commands : \n```\ngit clone https://github.com/AzeemIdrisi/PhoneSploit-Pro.git\n```\n```\ncd PhoneSploit-Pro/\n```\n```\npip install -r requirements.txt\n```\n1. Download and extract latest `platform-tools` from [here](https://developer.android.com/studio/releases/platform-tools.html#downloads).\n\n2. Copy all files from the extracted `platform-tools` or `adb` directory to __PhoneSploit-Pro__ directory and then run :\n\n```\npython phonesploitpro.py\n```\n\n# Tutorial\n\n\n## Setting up Android Phone for the first time\n\n* __Enabling the Developer Options__\n\n1. Open `Settings`.\n2. Go to `About Phone`.\n3. Find `Build Number`.\n4. Tap on `Build Number` 7 times.\n5. Enter your pattern, PIN or password to enable the `Developer options` menu.\n6. The `Developer options` menu will now appear in your Settings menu.\n\n* __Enabling USB Debugging__\n\n1. Open `Settings`.\n2. Go to `System` \u003e `Developer options`.\n3. Scroll down and Enable `USB debugging`.\n\n* __Connecting with Computer__\n\n1. Connect your Android device and `adb` host computer to a common Wi-Fi network.\n2. Connect the device to the host computer with a USB cable.\n3. Open a terminal in the computer and enter the following command :\n```\nadb devices\n```\n4. A pop-up will appear in the Android phone when you connect your phone to a new PC for the first time : `Allow USB debugging?`.\n5. Click on `Always allow from this computer` check-box and then click `Allow`.\n6. Then in the terminal enter the following command :\n```\nadb tcpip 5555\n```\n7. Now you can connect the Android Phone with the computer over Wi-Fi using `adb`.\n8. Disconnect the USB cable.\n9. Go to `Settings` \u003e  `About Phone` \u003e `Status` \u003e `IP address` and note the phone's `IP Address`.\n10. Run __PhoneSploit Pro__ and select `Connect a device` and enter the target's `IP Address` to connect over Wi-Fi.\n\n\n\n## Connecting the Android phone for the next time\n\n1. Connect your Android device and host computer to a common Wi-Fi network.\n2. Run __PhoneSploit Pro__ and select `Connect a device` and enter the target's `IP Address` to connect over Wi-Fi.\n\n\n# This tool is tested on\n\n-  ✅ Ubuntu\n-  ✅ Linux Mint\n-  ✅ Kali Linux\n-  ✅ Fedora\n-  ✅ Arch Linux\n-  ✅ Parrot Security OS\n-  ✅ Windows 11\n-  ✅ Termux (Android)\n\n\u003e [!NOTE]\n\u003e All the new features are primarily tested on **Linux**, thus **Linux** is recommended for running PhoneSploit Pro.\nSome features might not work properly on Windows.\n\n# Installing ADB \n\n#### ADB on Linux :\n\nOpen terminal and paste the following commands :\n\n* __Debian / Ubuntu__\n```\nsudo apt update\n```\n```\nsudo apt install adb\n```\n\n* __Fedora__\n```\nsudo dnf install adb\n```\n\n* __Arch Linux / Manjaro__\n```\nsudo pacman -Sy android-tools\n```\n\nFor other Linux Distributions : [Visit this Link](https://developer.android.com/studio/releases/platform-tools#downloads)\n\n#### ADB on macOS :\n\nOpen terminal and paste the following command :\n\n```\nbrew install android-platform-tools\n```\n\nor Visit this link : [Click Here](https://developer.android.com/studio/releases/platform-tools.html#downloads)\n\n#### ADB on Windows :\n\nVisit this link : [Click Here](https://developer.android.com/studio/releases/platform-tools.html#downloads)\n\n#### ADB on Termux :\n```\npkg update\n```\n```\npkg install android-tools\n```\n\n\n# Installing Metasploit-Framework \n\n#### On Linux / macOS :\n```\ncurl https://raw.githubusercontent.com/rapid7/metasploit-omnibus/master/config/templates/metasploit-framework-wrappers/msfupdate.erb \u003e msfinstall \u0026\u0026 \\\n  chmod 755 msfinstall \u0026\u0026 \\\n  ./msfinstall\n ```\n \nor Follow this link : [Click Here](https://docs.metasploit.com/docs/using-metasploit/getting-started/nightly-installers.html#installing-metasploit-on-linux--macos)\n\nor Visit this link : [Click Here](https://www.metasploit.com/download)\n\n#### On Windows :\n\nVisit this link : [Click Here](https://www.metasploit.com/download)\n\nor Follow this link : [Click Here](https://docs.metasploit.com/docs/using-metasploit/getting-started/nightly-installers.html#windows-anti-virus-software-flags-the-contents-of-these-packages)\n\n# Installing scrcpy\n\nVisit the `scrcpy` GitHub page for latest installation instructions : [Click Here](https://github.com/Genymobile/scrcpy#get-the-app)\n\n**On Windows** : Copy all the files from the extracted **scrcpy** folder to **PhoneSploit-Pro** folder.\n\n\u003e [!IMPORTANT]  \n\u003e If `scrcpy` is not available for your Linux distro like **Kali Linux**, then you can either manually install it : [Manual Guide](https://github.com/Genymobile/scrcpy/blob/master/doc/linux.md),\nor build it with a few simple steps : [Build Guide](https://github.com/Genymobile/scrcpy/blob/master/doc/build.md#build-scrcpy)\n\n# Installing Nmap\n\n#### Nmap on Linux :\n\nOpen terminal and paste the following commands :\n\n* __Debian / Ubuntu__\n```\nsudo apt update\n```\n```\nsudo apt install nmap\n```\n\n* __Fedora__\n```\nsudo dnf install nmap\n```\n\n* __Arch Linux / Manjaro__\n```\nsudo pacman -Sy nmap\n```\n\nFor other Linux Distributions : [Visit this Link](https://nmap.org/download.html)\n\n#### Nmap on macOS :\n\nOpen terminal and paste the following command :\n\n```\nbrew install nmap\n```\n\nor Visit this link : [Visit this Link](https://nmap.org/download.html)\n\n#### Nmap on Windows :\n\nDownload and install the latest stable release : [Click Here](https://nmap.org/download.html#windows)\n\n#### Nmap on Termux :\n```\npkg update\n```\n```\npkg install nmap\n```\n\n\n\n# Disclaimer\n\n* Neither the project nor its developer promote any kind of illegal activity and are not responsible for any misuse or damage caused by this project.\n* This project is for educational purpose only.\n* Please do not use this tool on other people's devices without their permission.\n* Do not use this tool to harm others.\n* Use this project responsibly on your own devices only.\n* It is the end user's responsibility to obey all applicable local, state, federal, and international laws.\n\n\n# Developer\n\n\u003ca href=\"https://github.com/azeemidrisi/\"\u003e\n\u003c!--   \u003cimg src=\"https://contrib.rocks/image?repo=azeemidrisi/phonesploit-pro\" /\u003e --\u003e\n \u003cimg width=\"150px\" src=https://github.com/AzeemIdrisi/PhoneSploit-Pro/assets/112647789/a5fa646c-93a2-460f-bcb7-528fedb147e9 /\u003e\n\n\u003c/a\u003e\n\n\n**Azeem Idrisi** - [@AzeemIdrisi](https://github.com/azeemidrisi/)\n \n\n# Support Me\nIf you like my work you can support me via :\n\n\u003ca href=\"https://paypal.me/AzeemIdrisi\" target=\"_blank\"\u003e \u003ckbd\u003e \u003cimg\n        src=\"https://github.com/AzeemIdrisi/AzeemIdrisi/blob/main/docs/paypal-button-blue.png\" alt=\"PayPal\"\n        width=\"147\"\u003e\u003c/a\u003e \u003ca href=\"https://www.buymeacoffee.com/AzeemIdrisi\" target=\"_blank\"\u003e \u003ckbd\u003e \u003cimg src=\"https://github.com/AzeemIdrisi/AzeemIdrisi/blob/main/docs/default-yellow.png\" alt=\"Buy Me A Coffee\" width=\"200\"\u003e\u003c/a\u003e\n\n\u003chr\u003e\n\nCopyright © 2024 Mohd Azeem (github.com/AzeemIdrisi)\n","funding_links":["https://github.com/sponsors/AzeemIdrisi","https://paypal.me/AzeemIdrisi","https://www.buymeacoffee.com/AzeemIdrisi"],"categories":["Python","android-hacking","Tools","Engine"],"sub_categories":["Reverse Engineering"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAzeemIdrisi%2FPhoneSploit-Pro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAzeemIdrisi%2FPhoneSploit-Pro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAzeemIdrisi%2FPhoneSploit-Pro/lists"}