https://github.com/litefeel/adbtool
A friendly android adb command-line tool
https://github.com/litefeel/adbtool
adb adb-commands android
Last synced: 4 months ago
JSON representation
A friendly android adb command-line tool
- Host: GitHub
- URL: https://github.com/litefeel/adbtool
- Owner: litefeel
- License: mit
- Created: 2017-01-11T01:18:16.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2026-03-27T05:49:16.000Z (4 months ago)
- Last Synced: 2026-03-27T06:44:24.748Z (4 months ago)
- Topics: adb, adb-commands, android
- Language: Python
- Homepage: https://pypi.org/project/adbtool/
- Size: 1.44 MB
- Stars: 7
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Adbtool
A friendly android adb command-line tool
[](https://github.com/litefeel/adbtool/actions)
[](https://pypi.org/project/adbtool/)
[](https://pypi.org/project/adbtool/)
### Python Requirements
* python 3.10+
* Android SDK
### Commands
~~~
adbt -h
usage: adbt [options]
show android device list
options:
-h, --help show this help message and exit
-c CONFIG, --config CONFIG
global config
--version show program's version number and exit
sub commands:
{adb,devices,push,install,uninstall,apk,sign,ab,il2cpp}
adb forward adb arguments to selected devices
devices show android device list
push push files to android device
install install apk file
uninstall uninstall apk file
apk show apk packageName/activityName
sign sign apk with android debug(only windows)
ab extract unity asset bundle information
il2cpp extract unity il2cpp information
~~~
---
~~~
adbt adb -- devices
adbt adb -d 1 -- shell
adbt adb -d a -- shell pwd
adbt adb -- -H localhost devices
adbt adb -d 1 -- -d shell
~~~
`adbt adb` supports the same device selection flow as `install`, and adb arguments must
be placed after `--`.
- `-d/--devices` before `--` belongs to `adbt adb`
- everything after `--` is passed to the real `adb` binary without extra parsing
- `adbt adb -h` shows the `adbt` subcommand help
- `adbt adb -- -h` shows the real `adb` help
~~~
adbt adb -h
usage: adbt adb [-h] [-d [DEVICES ...]] -- [adb_args ...]
~~~
---
~~~
adbt devices -h
usage: adbt [options] devices [-h] [-d DEVICES [DEVICES ...]] [-l]
optional arguments:
-h, --help show this help message and exit
-d DEVICES [DEVICES ...], --devices DEVICES [DEVICES ...]
filter of devices, [n | serial | a] n:index of list(start with 1), serial:at least 2 char,
a:all
-l, --list show devices list
~~~
---
~~~
adbt push -h
usage: adbt [options] push [-h] [-r] [-n] [-j [HASHJSON]] [--hash [{sha1,mtime}]] [--localdir LOCALDIR]
[--remotedir REMOTEDIR] [--dontpush] [-d [DEVICES [DEVICES ...]]]
[path [path ...]]
positional arguments:
path file or directory
optional arguments:
-h, --help show this help message and exit
-r recursion all file
-n only push new file by last modify files, see -j
-j [HASHJSON] hash json file, default: ./$deviceMode_$deviceSerial.json
--hash [{sha1,mtime}]
hash function: mtime or sha1, default:mtime
--localdir LOCALDIR local prefix and remote prefix, will replace local prefix to remote prefix
--remotedir REMOTEDIR
local prefix and remote prefix, will replace local prefix to remote prefix
--dontpush only outout json file, not really push file to remote
-d [DEVICES [DEVICES ...]], --devices [DEVICES [DEVICES ...]]
filter of devices, [a | n | serial] a: all devices n: index of devices list(start with 1)
serial: devices serial (at least 2 char) not argument is show device list
~~~
---
~~~
adbt install -h
usage: adbt [options] install [-h] [-f] [--filter [FILTER ...]] [-r] [-d [DEVICES [DEVICES ...]]] [apkpath ...]
positional arguments:
apkpath
optional arguments:
-h, --help show this help message and exit
-f, --force install with adb -d -r
--filter [FILTER [FILTER ...]]
filtered by file name
-r, --run run app after install
-d [DEVICES [DEVICES ...]], --devices [DEVICES [DEVICES ...]]
filter of devices, [a | n | serial] a: all devices n: index of devices list(start with 1)
serial: devices serial (at least 2 char) not argument is show device list
~~~
- `install` accepts multiple apk paths and uses `adb install-multi-package` when more than one apk is provided.
- default install mode uses `adb -r`; `-f/--force` upgrades it to `adb -d -r`.
---
~~~
adbt apk -h
usage: adbt [options] apk [-h] [-r] [-d [DEVICES [DEVICES ...]]] [apkpath]
positional arguments:
apkpath
optional arguments:
-h, --help show this help message and exit
-r, --run run app
-d [DEVICES [DEVICES ...]], --devices [DEVICES [DEVICES ...]]
filter of devices, [a | n | serial] a: all devices n: index of devices list(start with 1)
serial: devices serial (at least 2 char) not argument is show device list
~~~