ADBTool is an educational project designed to demonstrate various functionalities and capabilities of the Android Debug Bridge (ADB). This tool provides a command-line interface to interact with Android devices, allowing users to perform a wide range of actions such as installing applications, pulling and pushing files, executing shell commands, and more.
The primary purpose of this project is to serve as a learning resource for individuals interested in understanding and experimenting with ADB commands and their applications. It is intended for educational purposes only and should not be used for any malicious activities.
- Prepare Attack: Enable stealth, persistent access, and start C2.
- Steal All Data: Exfiltrate all accessible data to
/sdcard/stolen_data. - Dump System Info: Dump system information to
/sdcard/system_info. - Simulate Ransomware: Simulate ransomware on the device.
- Install Malware: Install malware from a specified APK path.
- Execute Shell Command: Execute a shell command on the device.
- List Files: List files in a specified directory.
- Pull File: Pull a file from the device to the local machine.
- Push File: Push a file from the local machine to the device.
- Install APK: Install an APK on the device.
- Uninstall App: Uninstall an application from the device.
- Clear App Data: Clear data for a specified application.
- Reboot Device: Reboot the device.
- Take Screenshot: Take a screenshot and save it to the device.
- Get Device Info: Retrieve device information such as model, serial number, and Android version.
- Read Logcat: Read the logcat output from the device.
- Check Device Status: Check the ADB accessibility and root status of the device.
- C2 - Start Server: Start the C2 server (already integrated in Prepare Attack).
- C2 - Stop Server: Stop the C2 server.
- Exit: Exit the tool.
To run the tests for this project, follow these steps:
-
Ensure you have the necessary dependencies installed. You can do this by running:
./gradlew build
-
Run the tests using the following command:
./gradlew test -
The test results will be displayed in the console, and a detailed report will be generated in the
build/reports/tests/testdirectory.
This project is licensed under the MIT License. See the LICENSE file for more details.
- Comprehensive ADB Commands: Execute a wide range of ADB commands to interact with Android devices.
- Educational Resource: Learn and experiment with ADB commands in a safe and controlled environment.
- User-Friendly Interface: Simple and intuitive command-line interface for easy interaction.
- Detailed Documentation: Comprehensive documentation to guide users through the tool's functionalities.
Contributions are welcome! If you have any suggestions, bug reports, or feature requests, please open an issue or submit a pull request.
For any inquiries or questions, please contact us at email@example.com.