Skip to main content
Version: 20 Mar 2024

ADB Commands

Here are some of the most frequently used ADB commands.

For instructions on how to install and use adb, follow the ADB Setup Guide.


After entering the adb console with adb shell, you can quit by entering exit in the console.

Managing Apps

Installing an App

adb install <myApp.apk>

You can also type adb install and then drag the apk file into the terminal window.

Reinstalling an App

To replace a previously installed version of the app:

adb install -r <myApp.apk>

Uninstalling an App

adb uninstall <package-name>

This is not the name of the .apk file, but the name of the app. This is typically something like com.magicleap.myapp. In Unity you can find the package name by going to the Player Settings menu. You can also run the list packages command below.

Launching an App

Though it's easiest to launch an app by simply selecting it from the Home Menu, you can also launch an app over adb:

adb shell am start -S <package-name>

Closing an App

Though it's easiest to close an app by simply hitting the [X] button on the Home Menu, you can also close an app over adb:

adb shell am force-stop <package-name>

List All Installed Packages

adb shell pm list packages


Pairing a Controller

To pair a controller, connect the controller to the compute pack with a USBC<->C cable. If you have to connect over ADB, this command will accept the first controller in pairing mode that the device finds.

adb shell controller connect

Connect to WiFi

Enable WiFi

adb shell svc wifi enable

Connect to Network

adb shell wifi-ml connect-network <NETWORK-ID> wpa2 <PASSWORD> -h

Use ADB over WiFi

adb tcpip [-p] <portnumber (any number above 1024, default is 5555)>
adb connect <IP of the Magic Leap 2>:<portnumber>

Will only work after WiFi has already been configured, and will last until the next reboot.


Enable Bluetooth

adb shell
svc bluetooth enable

Disable Bluetooth

adb shell
svc bluetooth disable

Bluetooth Adapter Test

adb shell

The btadaptertest command gives you several options for interfacing with bluetooth devices. Here are the available commands you can use within btadaptertest:

l - Configure Snoop Log [param1 = 0 (disable), 1 (enable)]
e - Enable Bluetooth adapter
f - Disable Bluetooth adapter
g - Get Adapter State
d - Start Discovery
c - Cancel Discovery
j - Discover supported profiles for device [param1 = scannedDeviceIndex]
p - Pair device [param1 = scanDeviceIndex]
u - Unpair device [param1 = bondedDeviceIndex]
(run 'b' command before each unpair)
b - Print bonded devices and connection states
(use this to get bondedDeviceIndex used by other commands)
o - Set device friendly name (alias) [param1 = bondedDeviceIndex, param2 = name]
0 - Print connected profiles [param1 = bondedDeviceIndex]
1 - Connect device (all profiles) [param1 = bondedDeviceIndex]
2 - Disconnect device (all profiles) [param1 = bondedDeviceIndex]
3 - Connect a profile [param1 = bondedDeviceIndex, param2 = profileId]
4 - Disconnect a profile [param1 = bondedDeviceIndex, param2 = profileId]
h - Print adapter name
m - Set adapter name [param1 = newAdapterName]
w - Print adapter address
s - Set Discoverable Timeout [param1 = timeoutValue in seconds]
v - Set Scan Mode [param1 = scanMode]
(0 - None, 1 - Connectable, 2 - Discoverable and Connectable)
q - Quit

Pair and Connect Example

adb shell
p <index of bluetooth device found in discovery scan>
1 <index of bonded bluetooth device>

File Management

Pushing Files to Device

adb push <file(s)-to-push> <destination-path>

You can specify the destination file name as well, if you'd like the file to be renamed.

Pulling Files from Device

adb pull <file(s)-to-pull>

This pulls the files into the directory you're currently in. Make sure you cd to the proper directory first.


View Debug Logs (Live)

adb shell logcat | find "thing you're searching for"
adb shell logcat | find "thing you're searching for" > outputfile.txt

Show File System Usage

adb shell cmd storageusage-ml

Show Controller Info

adb shell controller info

Reset Head Pose

adb shell reset-headpose
adb shell dumpsys battery

Factory Reset

adb reboot bootloader
fastboot erase userdata
fastboot reboot

Wait For Device

Runs command after a device is detected, or omit command to just wait.

adb wait-for-device <command>

Additional Resources