drozer Installation

===================

To get drozer running you will need:

* a PC

* an Android device or emulator, running Android 2.1 (Eclair) or later

To get the most from drozer, your system will need a number of packages installed:

* Java

* Android Software Development Kit (SDK)

You should ensure that each of these is on your system path (you should be able

to execute adb and java).

Then, follow the instructions for your platform.

If you run anti-virus software on your system, it is recommended to exclude the

directory that you will install drozer into. Otherwise, parts of the

exploitation tools may be detected and removed.

Note: before upgrading, you should remove all previous version of drozer or

Mercury from your system. This will avoid potential problems with drozer

using parts of the old codebase.

Windows

-------

A Windows Installer is available for drozer, which builds a complete Python

environment on your PC with most of drozer's dependencies built in.

Before you start, make sure that you have the Java JDK installed, and your

JAVA_HOME environment variable points to this folder.

The drozer installation must be run as a Windows administrator.

To test the installation:

> C:\drozer\drozer.bat

usage: drozer [COMMAND]

Linux

-----

Download the latest version of drozer from the project site (mwr.to/drozer),

these contain a Python .egg file to install drozer.

First, you need to install drozer's dependencies, which should be available in

your distributions package repository.

* Python 2.7 with development headers

* Python Setuptools

* ia-32libs (if you have a 64-bit system)

Then, as root, install drozer's Python dependencies:

$ easy_install --allow-hosts pypi.python.org protobuf==2.4.1

$ easy_install twisted==10.2.0

Next, as root, install drozer itself:

$ easy_install ./drozer-2.3.0-py2.7.egg

It is recommended to double check the file permissions of the bundled aapt

executable. This is typically installed to:

/usr/local/lib/python2.7/dist-packages/drozer-<version>-py2.7.egg/

drozer/lib/aapt

It should have 755 permissions.

To test the installation:

$ drozer

usage: drozer [COMMAND]

$

Congratulations, you are ready to go.

Bash Completion

---------------

drozer support Bash Completion on Linux.

To enable this, create a file in /etc/bash_completion.d/drozer that contains:

_drozer()

{

local cur prev opts

COMPREPLY=()

cur="${COMP_WORDS[COMP_CWORD]}"

prev="${COMP_WORDS[COMP_CWORD-1]}"

opts=`/path/to/drozer-complete ${COMP_WORDS[@]} $COMP_CWORD 2> /dev/null`

COMPREPLY=( $(compgen -W "${opts}" -- ${cur}) )

return 0

}

complete -F _drozer drozer

Then run:

$ . /etc/bash_completion