Droid is a desktop application created to communicate with Android devices on the local network over the Android debug bridge (adb). You can access the Android device directly over USB or connect to the device through Droid via adb. Droid allows you to completely control the Android device using multiple options, including a CLI and a GUI.

IMPORTANT NOTE: Application does require Android debug bridge (adb) to be installed on the system.

Install

Droid can be installed via pip

pip install droid

GUI

If you would like to run the GUI, you can run this command to boot it up

droid
or
droid -g

Simple usage (CLI)

droid -ip 127.0.0.1 -c

CLI Options: https://github.com/azazelm3dj3d/droid#options

I would recommend running this command before doing anything else to confirm you can successfully connect to the Android device on your network

droid -ip 127.0.0.1 -c

Example(s)

This example connects to the Android device (127.0.0.1), removes the specified APK package (com.android.ui), and then uploads a new APK called test_apk_v1.apk

droid -ip 127.0.0.1 -c -rm -p com.android.ui -up ~/Downloads/test_apk_v1.apk

This example downloads a test images from the Android device onto your local machine (automatically saves it in the ~/Downloads folder on most platforms)

droid -ip 127.0.0.1 --download /sdcard/cool_pic.png

Once you're finished working within the environment, you can run this command to disconnect from the Android device:

droid -ip 127.0.0.1 -d

We now have the option to control the bluetooth service on Android devices. You can start the service by running this command (stopping the service uses the stop argument):

droid -ip 127.0.0.1 -bl=start

You can stop the service by running this command (starting the service uses the start argument):

droid -ip 127.0.0.1 -w=stop

NOTE: When turning the wifi off, if you are communicating with the Android device remotely, this will result in the device being disconnected and unusable until the network is re-established.

This command will take a screenshot of the current Android screen while monitoring Logcat in real-time:

droid -ip 127.0.0.1 -sl -o screenshot

More Info

A wiki for common Android snippets is also available. This wiki shows examples of how Droid can used with the Android operating system

Wiki: https://github.com/azazelm3dj3d/droid/wiki/Helpful-Android-Snippets