Android ADB Shell Executor

A modern PyQt6-based GUI application for executing Android ADB (Android Debug Bridge) commands with an intuitive interface. This tool allows you to control your Android device remotely through various pre-configured commands.

Features

• 🎨 Beautiful and modern PyQt6 user interface
• 📱 One-click execution of common ADB commands
• 🔧 Support for custom ADB commands
• 📤 Real-time command output display
• 🚀 Non-blocking execution (threading)
• ⚙️ Easy-to-use button-based interface organized by categories

Installation

Prerequisites

• Python 3.8 or higher
• Android device with ADB enabled
• ADB (Android Debug Bridge) installed on your system

Setup Instructions

1. Clone or download the repository:

cd /home/kali/Desktop/Android_ADB_Shell

2. Create a virtual environment:

python3 -m venv venv

3. Activate the virtual environment:

On Linux/Mac:

source venv/bin/activate

On Windows:

venv\Scripts\activate

4. Install required packages:

pip install -r requirement.txt

5. Run the application:

python GUI.py

Usage

Getting Started

1. Connect your Android device to your computer via USB
2. Enable USB Debugging on your Android device (Settings > Developer Options > USB Debugging)
3. Run the application using the command above
4. The application will display all available commands organized by category

Available Commands

📱 Device Management

• List Connected Devices: Display all connected Android devices

  • Command: adb devices

• Get Device Information: Retrieve detailed device properties

  • Command: adb shell getprop

• Reboot Device: Restart the connected device

  • Command: adb reboot

• Reboot to Bootloader: Boot device into bootloader mode

  • Command: adb reboot bootloader

• Reboot to Recovery: Boot device into recovery mode

  • Command: adb reboot recovery

📷 Camera Control

• Open Camera: Launch the default camera application

  • Command: adb shell am start -a android.media.action.IMAGE_CAPTURE

• Open Video Recorder: Launch the video recording application

  • Command: adb shell am start -a android.media.action.VIDEO_CAPTURE

• List Cameras: Display available camera features

  • Command: adb shell pm list features | grep camera

📸 Screen Control

• Take Screenshot: Capture a screenshot from the device

  • Command: adb shell screencap -p /sdcard/screenshot.png && adb pull /sdcard/screenshot.png

• Record Screen (10 sec): Record device screen for 10 seconds

  • Command: adb shell screenrecord --time-limit=10 /sdcard/recording.mp4 && adb pull /sdcard/recording.mp4

• Turn Screen On: Wake up the device screen

  • Command: adb shell input keyevent 224

• Turn Screen Off: Put the device screen to sleep

  • Command: adb shell input keyevent 223

• Lock Screen: Lock the device

  • Command: adb shell input keyevent 26

📦 App Installation

• List Installed Apps: Show all installed applications

  • Command: adb shell pm list packages

• Install APK: Install an APK file on the device

  • Command: adb install "path/to/file.apk"

• Uninstall App: Remove an application by package name

  • Command: adb uninstall package.name

• Clear App Cache: Clear cached data for a specific application

  • Command: adb shell pm clear package.name

ℹ️ System Information

• Get Android Version: Check the Android OS version

  • Command: adb shell getprop ro.build.version.release

• Get Device Model: Display device model name

  • Command: adb shell getprop ro.product.model

• Get Battery Info: Show detailed battery status and health

  • Command: adb shell dumpsys battery

• Get Storage Info: Display storage space usage

  • Command: adb shell df -h

• Get Memory Info: Show RAM and memory statistics

  • Command: adb shell free -h

⚙️ Device Control

• Open Settings: Launch device Settings application

  • Command: adb shell am start -a android.settings.SETTINGS

• Go Home: Navigate to device home screen

  • Command: adb shell input keyevent 3

• Open Recent Apps: Open recent applications list

  • Command: adb shell input keyevent 187

• Clear Notifications: Clear all device notifications

  • Command: adb shell service call notification 1

• Enable WiFi: Turn on WiFi connectivity

  • Command: adb shell svc wifi enable

• Disable WiFi: Turn off WiFi connectivity

  • Command: adb shell svc wifi disable

• Enable Bluetooth: Turn on Bluetooth connectivity

  • Command: adb shell service call bluetooth_manager 6

• Disable Bluetooth: Turn off Bluetooth connectivity

  • Command: adb shell service call bluetooth_manager 8

🔧 Custom Commands

• Execute Custom Command: Run any custom ADB command
  • Input your command in the text field and click "Execute Custom Command"
  • Example: adb shell ls /sdcard

Common ADB Commands Reference

Basic Commands

Command	Description
adb devices	List all connected devices
adb version	Show ADB version
adb help	Display help information

Device Information

Command	Description
adb shell getprop	Get all device properties
adb shell getprop ro.build.version.release	Get Android version
adb shell getprop ro.product.model	Get device model
adb shell getprop ro.serialno	Get device serial number
adb shell wm size	Get screen resolution

Package Management

Command	Description
adb shell pm list packages	List all installed packages
adb install file.apk	Install an APK file
adb uninstall package.name	Uninstall an application
adb shell pm clear package.name	Clear app cache and data
adb shell pm grant package.name permission	Grant permissions

File Management

Command	Description
adb push local_file device_path	Copy file to device
adb pull device_path local_path	Copy file from device
adb shell ls /path	List directory contents
adb shell rm /path/file	Delete a file
adb shell mkdir /path	Create a directory

Screen & Display

Command	Description
adb shell screencap -p /sdcard/file.png	Take screenshot
adb shell screenrecord /sdcard/video.mp4	Record screen
adb shell input keyevent 26	Lock screen
adb shell input keyevent 3	Go to home
adb shell input tap X Y	Tap on coordinates

System Control

Command	Description
adb reboot	Restart device
adb reboot bootloader	Reboot to bootloader
adb reboot recovery	Reboot to recovery
adb shell dumpsys battery	Get battery info
adb shell getprop ro.build.fingerprint	Get device fingerprint

Network & Connectivity

Command	Description
adb shell svc wifi enable	Enable WiFi
adb shell svc wifi disable	Disable WiFi
adb shell service call bluetooth_manager 6	Enable Bluetooth
adb shell service call bluetooth_manager 8	Disable Bluetooth
adb shell getprop dhcp.wlan0.ipaddress	Get device IP address

Logs & Debugging

Command	Description
adb logcat	View device logs
adb logcat -c	Clear logs
adb bugreport	Generate bug report
adb shell dmesg	View kernel logs

Interface Overview

Left Panel - Commands

• Organized into 7 collapsible categories
• Quick-click buttons for common operations
• Text input fields for custom parameters (APK path, package names, etc.)
• Scrollable interface for easy navigation

Right Panel - Output

• Real-time command execution results
• Color-coded output (green text on dark background)
• Success indicators (✓) and error indicators (✗)
• Clear Output button to reset the display

Troubleshooting

ADB Not Recognized

• Ensure ADB is properly installed on your system
• Add ADB to your system PATH
• Restart the application after installing ADB

Device Not Detected

• Enable USB Debugging on your Android device
• Try a different USB cable
• Restart the ADB daemon: adb kill-server then adb devices
• Update your device drivers

Permission Denied Errors

• Some commands require root/superuser access
• Your device may need to grant USB Debugging permissions
• Check the authorization dialog on your device

Virtual Environment Issues

• Always activate the virtual environment before running the app
• Use source venv/bin/activate on Linux/Mac
• Use venv\Scripts\activate on Windows

System Requirements

• OS: Windows, macOS, or Linux
• Python: 3.8 or higher
• RAM: Minimum 512 MB
• Storage: Minimum 100 MB for installation

Dependencies

• PyQt6: Modern GUI framework
• Python subprocess module (standard library)

See requirement.txt for the complete list of dependencies.

License

This project is open source and available for educational and personal use.

Support & Contribution

For issues, suggestions, or contributions, please feel free to open an issue or submit a pull request.

Disclaimer

• Use this tool responsibly and only on devices you own or have permission to access
• Some ADB commands may void your device warranty
• Always back up important data before executing device modifications
• The author is not responsible for any damage caused by improper usage

Version

Version 1.0.0

---

Happy ADB-ing! 🚀