Repolode
Submit
mzlogin

mzlogin/awesome-adb

A large bilingual reference of Android Debug Bridge (adb) commands for installing apps, managing files, viewing logs, and device info.

View on GitHubWebsite
Stars
12,523
Forks
2,287
Open issues
52
Last commit
last month

What is it?

awesome-adb is a categorized reference of Android Debug Bridge (adb) commands. It covers the situations Android developers, testers, and device enthusiasts run into most often: connecting devices over USB or Wi-Fi, installing and uninstalling APKs, listing and disabling packages, clearing app data, and launching activities or services with the am and pm tools.

Beyond connection and app management, it documents file push and pull, simulating key presses and text input through the input command, filtering logcat output by level and tag, and reading hardware and system properties such as model, battery, screen density, CPU, and memory. It also lists common APK install error codes with their meanings and suggested fixes, plus notes on root-only commands and version-dependent behavior across Android releases and custom ROMs.

The content is maintained as a Markdown document with a table of contents, and an English version is linked from the README.

Key features

  • 01Covers USB and Wi-Fi device connection, including Android 11+ wireless debugging.
  • 02Lists install and uninstall commands with a table of common INSTALL_FAILED error codes and fixes.
  • 03Shows how to query, enable, disable, and clear app packages with pm.
  • 04Documents launching activities, services, and broadcasts with am, including common system broadcast actions.
  • 05Explains simulating key events and text input with the input command, with a keycode reference.
  • 06Describes filtering logcat output by level and tag, plus reading device hardware and system properties.

Use cases

  • Installing, updating, or debugging an APK on a physical device or emulator.
  • Looking up the adb command for a specific task without searching through scattered sources.
  • Diagnosing an APK install failure by matching the error code to a suggested fix.
  • Scripting device automation such as sending key events or triggering broadcasts for testing.

Quick start

  1. 1

    Connect your Android device with USB and check it is detected

    adb devices
  2. 2

    Install an app from an APK file

    adb install <path_to_apk>
  3. 3

    List installed third-party apps

    adb shell pm list packages -3

Things to know

  • This is a reference document of commands, not a software tool, so it has no installable program.
  • Some commands depend on the Android version and the device's custom ROM.

In collections

Android apps & phone tools

Topics

#android#adb#command-line#debugging#android-debug-bridge#reference#android-adb

FAQ

What is awesome-adb?
A large bilingual reference of Android Debug Bridge (adb) commands for installing apps, managing files, viewing logs, and device info. awesome-adb is a categorized reference of Android Debug Bridge (adb) commands. It covers the situations Android developers, testers, and device enthusiasts run into most often: connecting devices over USB or Wi-Fi, installing and uninstalling APKs, listing and disabling packages, clearing app data, and launching activities or services with the am and pm tools.
Is awesome-adb free to use? What license does it have?
awesome-adb is open source under the MIT license. Check the license terms before using it in commercial products.
Is awesome-adb still maintained?
Updated within 6 months. The last commit to awesome-adb was on Sep 29, 2026.
What can I use awesome-adb for?
Installing, updating, or debugging an APK on a physical device or emulator. Looking up the adb command for a specific task without searching through scattered sources. Diagnosing an APK install failure by matching the error code to a suggested fix. Scripting device automation such as sending key events or triggering broadcasts for testing.
How do I install awesome-adb?
Connect your Android device with USB and check it is detected: adb devices Install an app from an APK file: adb install <path_to_apk> List installed third-party apps: adb shell pm list packages -3
Where can I get awesome-adb?
The source code and installation instructions are on GitHub: https://github.com/mzlogin/awesome-adb

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects