TaintDroid project to automatically analyze the behaviour of Android applications in an emulated environment by parsing TaintDroid logs indicating that an application leaks privacy sensitive information or generates cost for the user.
The TaintDroid Runner project was created as part of my (Daniel Baeumges) Master's Thesis at the Ruhr-Universität Bochum. Questions and feedback regarding the TaintDroid Runner project can be sent to me directly (<first-initial><lastname> -at- gmail.com"), or to the TaintDroid users Google Groups, which I try to monitor regular.
The excerpt of my Master's thesis can be viewed and downloaded here.
The appropriate part of a short presentation can be found here.
Todos and ideas
Usage: taintdroid_runner.py [options] mode
--version show program's version number and exit
-h, --help show this help message and exit
-a <app>, --app=<app>
Set path to Android app to run in TaintDroid
-d <directory>, --appDir=<directory>
Set directory in which all Android apps should be run
-i <path>, --imageDirPath=<path>
Set path to the TaintDroid 2.3 image files zImage,
system.img, ramdisk.img, and sdcard.img
-t #, --numThreads=# Number of threads to be used
Maximum seconds for thread
First emulator port (has to be an even number)
Report directory in which all files are stored (date
-l <path>, --logPathSuffix=<path>
Set path to directory in which log and logcat files
should be stored
--storeLogInFile Set to true (1) if outputs should be logged in
Define the maximum logcat size in kBytes (logcat is
ringbuffer), default is 4096kByes
--sdkPath=<path> Set path to Android SDK
--avdName=<name> Set the name of the AVD to be used
--runHeadless Run emulator without window.
--numMonkeyEvents=# Define number of monkey events to be executed (split
into up to 5 separate runs).
--cleanUpImageDir Set to false (0) if image dir should not be removed
--sleepTime=<secs> Set time to sleep during simulation.
The mode might be:
When you do not have or do not want do build the sources you need to follow these steps:
Example start command of the TaintDroid Runner:
python taintdroid_runner.py -a ~/com.test.apk \
-i taintdroid_images_clean \
--sdkPath ~/bin/android-sdk-linux_x86/ \
python taintdroid_runner.py -a ~/com.test.apk
Dependent on the provided options several log and logcat files are created.
The TaintDroid Runner files can be downloaded in the files section or via this direct link. The archive consist of the Python files only.