DroidBot

Prerequisite

1. Python (Python 3.10 is recommended)
2. Java (JDK1.8 is recommended. Available here )
3. Android SDK (All you need is platform_tools. Available here: Windows Linux Mac )
4. Add platform_tools directory in Android SDK to PATH

How to install

Clone this repo and install with pip:

conda create -n droidbot python=3.10 -y
conda activate droidbot
#pip install -U -e .
pip install -r requirements.txt

If successfully installed, you should be able to execute droidbot -h.

How to use

Place the apk according to the following directory structure:

apks_dir
├─communication
├───com.whatsapp.w4b.apk
├───com.google.android.contacts.apk
├───......
├─entertainment
├─productivity
├─shopping
├─social
├─tools
└─video_players

Connect your android devices to that computer via adb, you should be able to see them via the adb devices command, the string like "HA1PZJW9" in there is device_serial, you need to replace the "HA1PZJW9".

conda activate droidbot
python run.py -d HA1PZJW9 -i path/to/apks_dir -o path/to/output_dir -c tools
#-d: The serial number of target device (use `adb devices` to find)
#-i: directory of input
#-o: directory of output
#-c: category of APKs, must be a subdirectory of the input folder

Acknowledgement

1. AndroidViewClient
2. Androguard
3. The Honeynet project
4. Google Summer of Code
5. DroidBot