Awesome Open Source
Awesome Open Source

Welcome to Mobly

Mobly is a Python-based test framework that specializes in supporting test cases that require multiple devices, complex environments, or custom hardware setups.

Here are some example use cases:

  • P2P data transfer between two devices
  • Conference calls across three phones
  • Wearable device interacting with a phone
  • Internet-Of-Things devices interacting with each other
  • Testing RF characteristics of devices with special equipment
  • Testing LTE network by controlling phones, base stations, and eNBs

Mobly can support many different types of devices and equipment, and it's easy to plug your own device or custom equipment/service into Mobly.

Mobly comes with a set of libs to control common devices like Android devices.

While developed by Googlers, Mobly is not an official Google product.


Mobly requires python 3.6 or newer.

Mobly tests could run on the following platforms:

  • Ubuntu 14.04+
  • MacOS 10.6+
  • Windows 7+
Platform Build Status
Linux Linux Build Status
Windows Windows Build Status

System dependencies

  • adb (1.0.40+ recommended)
  • python3.6+
  • python-setuptools

To use Python3, use pip3 and python3 (or python3.x) accordingly.


You can install the released package from pip

pip install mobly

or download the source then run to use the bleeding edge:

git clone
cd mobly
python install

You may need sudo for the above commands if your system has certain permission restrictions.


Mobly Snippet

The Mobly Snippet projects let users better control Android devices.

  • Mobly Snippet Lib: used for triggering custom device-side code from host-side Mobly tests. You could use existing Android libraries like UI Automator and Espresso.
  • Mobly Bundled Snippets: a set of Snippets to allow Mobly tests to control Android devices by exposing a simplified version of the public Android API suitable for testing.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
python (55,393
android (6,459
windows (1,507
testing (978
automation (737
mobile (493
networking (420
google (414
robotics (350
android-app (246
android-development (224
wifi (201
bluetooth (192
test-automation (112
phone (84
telephony (22