Skip to main content

An ADB wrapper for Android developers

Project description

# adb-enhanced [![Downloads](http://pepy.tech/badge/adb-enhanced)](http://pepy.tech/project/adb-enhanced)

Swiss-army knife for android testing and development, inspired from [android-scripts](https://github.com/dhelleberg/android-scripts)

# Release announcement
See [https://ashishb.net/tech/introducing-adb-enhanced-a-swiss-army-knife-for-android-development/](https://ashishb.net/tech/introducing-adb-enhanced-a-swiss-army-knife-for-android-development/)


# Installation
`sudo pip3 install adb-enhanced`

## Note
1. `sudo pip install adb-enhanced` for python2 based install works as well but I would recommend moving to python3 since I might deprecate python2 support at some point.
2. If you don't have sudo access or you are installing without sudo then the tool will still be installed but `adbe` might not be configured correctly in the path.


# Examples

* Turn doze mode on

`adbe doze on`

* Turn mobile-data off

`adbe mobile-data off`

* Turn on battery saver

`adbe battery saver on`

* Don't keep activities in the background

`adbe dont-keep-activities on`

* Grant storage-related runtime permissions

`adbe permissions grant com.example.android storage`

* Revoke storage-related runtime permissions

`adbe permissions revoke com.example.android storage`

* ls/cat any file without worrying about adding "run-as"

`adbe ls /data/data/com.example/databases` # Works as long as com.example is a debuggable package

* Launch an app
`adbe start com.example`

# Usage

adbe.py [options] rotate (landscape | portrait | left | right)
adbe.py [options] gfx (on | off | lines)
adbe.py [options] overdraw (on | off | deut)
adbe.py [options] layout (on | off)
adbe.py [options] airplane (on | off)
adbe.py [options] battery level <percentage>
adbe.py [options] battery saver (on | off)
adbe.py [options] battery reset
adbe.py [options] doze (on | off)
adbe.py [options] jank <app_name>
adbe.py [options] devices
adbe.py [options] top-activity
adbe.py [options] mobile-data (on | off)
adbe.py [options] mobile-data saver (on | off)
adbe.py [options] rtl (on | off)
adbe.py [options] screenshot <filename.png>
adbe.py [options] screenrecord <filename.mp4>
adbe.py [options] dont-keep-activities (on | off)
adbe.py [options] animations (on | off)
adbe.py [options] input-text <text>
adbe.py [options] press back
adbe.py [options] open-url <url>
adbe.py [options] permission-groups list all
adbe.py [options] permissions list (all | dangerous)
adbe.py [options] permissions (grant | revoke) <app_name> (calendar | camera | contacts | location | microphone | phone | sensors | sms | storage)
adbe.py [options] standby-bucket get <app_name>
adbe.py [options] standby-bucket set <app_name> (active | working_set | frequent | rare)
adbe.py [options] restrict-background (true | false) <app_name>
adbe.py [options] ls [-l] [-R] <file_path>
adbe.py [options] pull [-a] <remote>
adbe.py [options] pull [-a] <remote> <local>
adbe.py [options] cat <file_path>
adbe.py [options] start <app_name>
adbe.py [options] stop <app_name>
adbe.py [options] force-stop <app_name>
adbe.py [options] clear-data <app_name>
adbe.py [options] app-info <app_name>
adbe.py [options] print-apk-path <app_name>


# Options

-e, --emulator directs command to the only running emulator
-d, --device directs command to the only connected "USB" device
-s, --serial SERIAL directs command to the device or emulator with the given serial number or qualifier.
Overrides ANDROID_SERIAL environment variable.
-l For long list format, only valid for "ls" command
-R For recursive directory listing, only valid for "ls" command
-v, --verbose Verbose mode

## Python3 compatibility

As of Nov 27, 2017, the code is python3 compatible and as of Jan 18, 2018, pip (python package manager) also has the updated version

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

adb-enhanced-1.7.1.tar.gz (11.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

adb_enhanced-1.7.1-py3-none-any.whl (12.7 kB view details)

Uploaded Python 3

File details

Details for the file adb-enhanced-1.7.1.tar.gz.

File metadata

  • Download URL: adb-enhanced-1.7.1.tar.gz
  • Upload date:
  • Size: 11.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for adb-enhanced-1.7.1.tar.gz
Algorithm Hash digest
SHA256 e60b73e0e143a3bcd673a5c2686040b28a7b3fc33382e24fb8fd19868c5c3100
MD5 2757055df28a84396c8732aa0f9eabfa
BLAKE2b-256 61895333b57dea6b3a8fcaa01152ee06432d8a5e33d1da25204845e82c11e292

See more details on using hashes here.

File details

Details for the file adb_enhanced-1.7.1-py3-none-any.whl.

File metadata

File hashes

Hashes for adb_enhanced-1.7.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6b6bd81a349e262e818c6816469ffac8a2a87530ab6beba80a3e8d981a09cc0b
MD5 b05633ac1b13a29839340a972a4196e9
BLAKE2b-256 abd548d3d556f5891e661d2a7b74d4d3b8203164b29113e3340804de40ca6e5a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page