Cerium: A Toy for Android Automation

Release v1.2.6. (Installation)

Platform License Latest version on PyPi Wheel supported Supported Python versions Documentation status

Cerium is an Android automation framework for Python, safe for human consumption.


The use of Python 3 is highly preferred over Python 2. And I prefer the latest version of Python. So Cerium only supports Python 3.6 officially. Consider upgrading your applications and infrastructure if you find yourself still using Python 2 in production today.

Behold, the power of Cerium:

>>> from cerium import AndroidDriver
>>> driver = AndroidDriver()
>>> driver.unlock(1997)   # unlock your device by password
>>> driver.auto_connect()   # connect to your device via TCP/IP automatically
Now you can unplug the USB cable, and control your device via WLAN.
>>> driver.view_packgets_list(keyword='tencent')
['com.tencent.mm', 'com.tencent.android.qqdownloader', 'com.tencent.tim']
>>> driver.make_a_call(18268237856)   # call me

Cerium allows you to send organic, grass-fed commands, without the the need for manual labor.

The User Guide

This part of the documentation, which is mostly prose, begins with some background information about Cerium, then focuses on step-by-step instructions for getting the most out of Cerium.

The API Documentation / Guide

If you are looking for information on a specific function, class, or method, this part of the documentation is for you.

The Contributor Guide

If you want to contribute to the project, this part of the documentation is for you.

There are no more guides. You are now guideless. Good luck.