We use cookies.This website uses essential cookies to operate core features. With your consent, we also use analytics cookies to understand traffic and improve the service. For more details, see our .
Was this tool helpful to use?
Your feedback helps us make it better
Search 76 ADB command records with English explanations, syntax and notes.
Selected ADB/Android shell command reference; no device is connected or operated here. Check device/Platform-Tools versions and permissions. backup/restore are historical, not guaranteed available; destructive and system commands alter device state. Reference
List connected Android devices and their ADB states.
adb devices [-l]adb devices -lConnect to a device over TCP/IP after network debugging has been enabled.
adb connect <host>[:port]adb connect 192.168.1.20:5555Disconnect a TCP/IP device, or all TCP/IP connections when no address is supplied.
adb disconnect [host[:port]]adb disconnect 192.168.1.20:5555Pair with wireless debugging on Android 11 or later using the device pairing code.
adb pair <host>:<port>adb pair 192.168.1.20:37123Restart adbd in TCP/IP listening mode on the specified port.
adb tcpip <port>adb tcpip 5555Restart adbd in USB listening mode.
adb usbadb usbStop the local ADB server to reset a connection.
adb kill-serveradb kill-serverStart the local ADB server; most ADB commands also start it automatically.
adb start-serveradb start-serverSelect a device by serial number when multiple devices are connected.
adb -s <serial> <command>adb -s emulator-5554 shell pm list packagesWait until the selected device reaches the ADB device state; this does not guarantee Android has finished booting.
adb wait-for-device [next-command]adb wait-for-device shell getprop ro.product.modelShow the local ADB client version.
adb versionadb versionShow the selected device state, such as device, bootloader, or offline.
adb get-stateadb get-stateShow the selected device serial number.
adb get-serialnoadb get-serialnoRead Android system properties such as model, version, or SDK level.
adb shell getprop [name]adb shell getprop ro.build.version.releaseInspect battery level, temperature, and charging status.
adb shell dumpsys batteryadb shell dumpsys batteryInspect memory usage for a process or package.
adb shell dumpsys meminfo [package|pid]adb shell dumpsys meminfo com.android.chromeRead or override the device display resolution.
adb shell wm size [WxH|reset]adb shell wm size 1080x1920Read or override the device display density.
adb shell wm density [dpi|reset]adb shell wm density 320Install an APK, with options for replacement, test packages, permitted downgrades, and runtime permissions.
adb install [-r|-t|-d|-g] <apk>adb install -r app-release.apkInstall multiple APK files together, such as a base APK and its splits; an AAB is not installed directly.
adb install-multiple [options] <apk...>adb install-multiple base.apk config.armeabi_v7a.apkUninstall an application by package name.
adb uninstall [-k] <package>adb uninstall com.example.appList application package names on the device.
adb shell pm list packages [-3|-s|-f]adb shell pm list packages -3Show the installed APK path for a package.
adb shell pm path <package>adb shell pm path com.android.chromeClear an application's data and cache while leaving the application installed.
adb shell pm clear <package>adb shell pm clear com.example.appDisable an application for a specified user.
adb shell pm disable-user [--user <id>] <package>adb shell pm disable-user --user 0 com.example.bloatStart an activity using an intent or component name.
adb shell am start [-n component|-a action]adb shell am start -n com.android.settings/.SettingsForce-stop an application by package name.
adb shell am force-stop <package>adb shell am force-stop com.example.appSend a broadcast intent for testing where device permissions allow it.
adb shell am broadcast -a <action> [extras]adb shell am broadcast -a android.intent.action.BOOT_COMPLETEDSend pseudorandom input events to an application for stress testing.
adb shell monkey [options] -p <package> <count>adb shell monkey -p com.example.app -v 500Copy a local file or directory to a device path.
adb push <local> <remote>adb push ./config.json /sdcard/Download/Copy a file or directory from the device to the host.
adb pull <remote> [local]adb pull /sdcard/DCIM/Camera ./photosSynchronize platform build files to the corresponding device partitions.
adb sync [partition]adb sync systemList files and directories on the device.
adb shell ls [-l|-a] <path>adb shell ls -l /sdcard/Delete device files or directories; check the target path before running.
adb shell rm [-r|-f] <path>adb shell rm -rf /sdcard/Download/tmpCopy a file or directory within the device.
adb shell cp [-r] <src> <dst>adb shell cp /sdcard/a.txt /sdcard/b.txtMove or rename a device file or directory.
adb shell mv <src> <dst>adb shell mv /sdcard/a.log /sdcard/old/a.logCreate a directory on the device, optionally creating missing parents.
adb shell mkdir [-p] <dir>adb shell mkdir -p /sdcard/MyApp/cacheRead system and application logs, with optional format and tag filters.
adb logcat [options] [filterspec]adb logcat '*:E'Clear the selected logcat buffers.
adb logcat -cadb logcat -cDump currently buffered logs and exit.
adb logcat -dadb logcat -d > device.logSelect a log output format such as time, threadtime, or long.
adb logcat -v <format>adb logcat -v threadtimeCollect a diagnostic bug report containing device logs and service state.
adb bugreport [path]adb bugreport ./bugreport.zipRead the kernel ring buffer where device permissions permit it.
adb shell dmesgadb shell dmesg | tail -n 100Open an interactive device shell or run a single shell command.
adb shell [command]adb shellSimulate text input into the focused field; supported characters depend on the input method.
adb shell input text <text>adb shell input text helloSimulate an Android key event.
adb shell input keyevent <code>adb shell input keyevent 4Simulate a tap at specified screen coordinates.
adb shell input tap <x> <y>adb shell input tap 500 1200Simulate a swipe with an optional duration.
adb shell input swipe <x1> <y1> <x2> <y2> [ms]adb shell input swipe 300 1000 300 200 200Read or write a setting in the system, global, or secure namespace when permissions allow it.
adb shell settings [get|put] <ns> <key> [value]adb shell settings put global airplane_mode_on 1Capture the device screen as a PNG file.
adb shell screencap -p <path>adb shell screencap -p /sdcard/screen.pngRecord the screen to an MP4 file where screenrecord is available.
adb shell screenrecord [options] <path>adb shell screenrecord --time-limit 30 /sdcard/demo.mp4Stream a screenshot directly to the host without an intermediate device file.
adb exec-out screencap -p > <local.png>adb exec-out screencap -p > screen.pngReboot normally or request a supported boot mode.
adb reboot [bootloader|recovery|sideload]adb reboot recoveryRestart adbd with root privileges on a compatible debug build.
adb rootadb rootRestart adbd without root privileges.
adb unrootadb unrootRemount supported partitions as writable where the device build permits it.
adb remountadb remountDisable verified filesystem checks on a compatible debug device.
adb disable-verityadb disable-verityRe-enable verified filesystem checks on a compatible debug device.
adb enable-verityadb enable-veritySend a compatible update package to recovery using ADB sideload.
adb sideload <package.zip>adb sideload update.zipCreate a legacy .ab backup on devices that still support this deprecated feature.
adb backup [options] [-f file]adb backup -all -f backup.abRestore a legacy .ab backup on a compatible device.
adb restore <file>adb restore backup.abForward a host port to a device endpoint.
adb forward <local> <remote>adb forward tcp:8080 tcp:8080List ADB forward mappings.
adb forward --listadb forward --listRemove a host-to-device port forwarding rule.
adb forward --remove <local>adb forward --remove tcp:8080Forward a device port to a host endpoint.
adb reverse <remote> <local>adb reverse tcp:3000 tcp:3000List ADB reverse mappings.
adb reverse --listadb reverse --listRemove a device-to-host port forwarding rule.
adb reverse --remove <remote>adb reverse --remove tcp:3000Inspect network interfaces and their addresses on the device.
adb shell ip addradb shell ip addr show wlan0Send ICMP probes from the device to test reachability.
adb shell ping <host>adb shell ping -c 4 8.8.8.8List debuggable Java process IDs available to JDWP.
adb jdwpadb jdwpInspect current process CPU and memory usage.
adb shell top [-n <times>]adb shell top -n 1List a snapshot of running device processes.
adb shell ps [-A|-T]adb shell ps -A | grep com.exampleDump the state of a named system service, or all services when none is supplied.
adb shell dumpsys [service]adb shell dumpsys activity activitiesSet a system property where device permissions allow it.
adb shell setprop <name> <value>adb shell setprop log.tag.MyTag VERBOSEStart or stop method tracing for a process.
adb shell am profile start|stop <process> [file]adb shell am profile start com.example /sdcard/trace.traceRun an activity-service subcommand available on the installed Android version.
adb shell cmd activity <subcmd>adb shell cmd activity start -n com.example/.MainActivityOverview
Understand what the tool solves, how it works, and the boundaries of its data.
This ADB command reference is a searchable collection of 76 records for common Android Debug Bridge and Android shell commands. Use it when you know the task—such as checking a connection, installing an APK, reading logs, or moving a file—but need a syntax reminder or a worked command line. ADB itself is a command-line tool used from a computer to communicate with an Android device or emulator. Its commands can be handled by the computer-side client or sent to the device, depending on the command. Android Developers’ ADB documentation describes these roles and the main command groups.
The reference groups records into device connection, device information, app management, file transfer, log debugging, shell operations, screen capture, system operations, network and ports, and performance debugging. Each record presents a command name, short description, syntax, and example; some include a note about options or conditions. The collection is a practical index, not an exhaustive inventory of every command in every Platform Tools release or every shell command available on Android.
In a syntax line, text in angle brackets such as <serial>, <package>, <local>, or <remote> stands for a value you supply. Replace it with a real serial number, package name, or path before running the command. Brackets around an option commonly mark it as optional in the displayed syntax; the command’s own help is the authority for exact grammar. Example values are illustrative and may need to match your computer, device, Android release, and shell.
For instance, adb devices -l asks ADB to list connected devices with additional details. In a multi-device setup, adb -s emulator-5554 shell pm list packages makes the target explicit. The -s selector takes a device serial; confirm the value in your own device list before using it. The ADB project’s command manual documents the command-line options and syntax.
Type a command name or a task-related word in the keyword field. Matching is case-insensitive and checks the record’s command name, description, syntax, example, and any note. You can combine a keyword with one category to narrow the list; choose All to search across categories again. The result area shows the number of matches and the matching command cards, or an empty-state message when nothing matches.
Each card has separate copy actions for the command name, syntax, and example. Copying places that text on your clipboard for review in a terminal or script. The page is a reference only: it does not connect to a phone, inspect your installed ADB version, validate a command against your device, or execute commands for you.
Guide
Follow the workflow and verify inputs and outputs with practical examples.
Start with the outcome you need. Search a command such as adb pull, or a task word such as logcat, install, or screenshot.
Use a category if the results are broad. For example, choose File Transfer for push or pull, or Log Debugging for log collection and filtering.
Read the description and syntax together, then check the example and note. Replace placeholders with your actual values; do not paste angle-bracket placeholders literally.
Copy the syntax or example, inspect the target device and paths, then run it in a terminal where ADB is installed. If several devices are connected, first check adb devices -l and add adb -s <serial> to commands that need a specific target.
If no record matches, try a command fragment, a shorter task word, or another category. Consult the help for your installed ADB build for commands or flags that are not listed.
For a basic connection check, search devices. For an APK install, look up adb install and use the path to the APK on your computer. For a device-to-computer file copy, look up adb pull; for a computer-to-device copy, use adb push. These commands use different path directions, so verify which side each path belongs to before execution.
For logs, search logcat and inspect the filter syntax and shell quoting note. A filter that works in one terminal may need different quoting in another. When collecting output to a local file, the redirection operator is interpreted by your computer’s shell, not by the reference page.
Use cases
See how the tool fits into real work and everyday tasks.
A developer or tester can search for an install, package, launch, or log command, compare its syntax with the example, then adapt package and file names to the current build. The reference helps retrieve a command pattern; the tester still checks the target emulator or phone before running it.
When a bug report needs logs, a screenshot, or a device-side file, search the relevant category and inspect the record notes. Copy the command text, confirm the output destination, and review collected files for credentials or personal information before sharing them.
If multiple phones or emulators are connected, use the connection records to check their serials and select the intended target explicitly. This reduces the chance of installing, clearing, or collecting data from the wrong device.
Q&A
Find concise answers to common questions and confusing cases.
No. It filters and displays command text and provides copy actions. ADB must be available in your computer’s terminal, and you run the chosen command yourself.
ADB options, Android shell commands, permissions, and build capabilities vary. Check the installed ADB help and the official documentation, confirm the selected device and paths, and check whether the operation requires a compatible build or elevated permission.
adb shell pm clear the same as reinstalling an app?No. It clears that app’s data and cache while leaving the app installed. Treat it as a data-changing operation and confirm the package name before running it.
Do not assume so. Backup and restore entries are legacy references with limited support on current devices. Check whether your device and installed tools still support them, and use a verified backup method appropriate to your device and data.
Notes
Review scope, result limitations, and important precautions before use.
ADB commands can change or remove data, alter system settings, stop apps, reboot a device, or expose diagnostic information. Before executing a copied line, verify the device serial, package, destination path, flags, and shell interpretation. Be especially careful with commands that clear app data, remove files, remount partitions, change settings, or run as root. Use debugging only on devices you own or are authorized to administer, and review logs or bug reports before sharing because they may contain sensitive information.
Command availability and behavior depend on the ADB version, Android release, device build, permissions, and host shell. Entries in this reference are examples for lookup, not a guarantee that a command will work or be safe in every environment. For exact current syntax, inspect the help from your installed ADB tools and the Android project documentation.
Related
Discover related tools, collections, and available API capabilities.