The Complete Guide to Side-loading Apps on Wear OS Using ADB Wireless

The Wear OS Google Play Store contains thousands of applications designed specifically for smartwatch screens. However, there are times when you might want to install an application that isn't officially available on the watch store. This could be a lightweight version of a messaging app, an older build of a health tracker, a utility like a custom file manager, or a beta application you're testing yourself. This process is called side-loading.

Because smartwatches don't typically have standard USB ports to connect directly to your PC, the side-loading process uses Android's built-in wireless Android Debug Bridge (ADB) interface. In this guide, we'll cover the prerequisites, configuration steps, and terminal commands needed to install any compatible APK onto your Wear OS watch.

Prerequisites: Getting Ready

Before executing the side-load commands, ensure you have gathered the following components:

• An Android APK File: Download the APK file you want to install. Ensure the app architecture is compatible (usually 32-bit ARM for older watches, or 64-bit ARM for newer Wear OS 4 and 5 watches).
• ADB Installed on Your PC: You need Android SDK Platform Tools. If you don't have them, download the official ZIP archive from the Android Developer site, extract it, and add the folder path to your system's Environment Variables (PATH).
• Local Network Access: Both your watch and your computer must be connected to the same Wi-Fi network.

Step 1: Enable Developer Options & Wi-Fi Debugging

Before you can send commands, your watch must allow debugging connections. (For a detailed breakdown, read our guide on How to Enable Developer Options on Wear OS).

1. Open Settings > System (or About Watch) > Software info.
2. Tap Build number 7 times until developer options are unlocked.
3. Go to Settings > Developer options, then enable ADB debugging.
4. Scroll down and select Wireless debugging. Turn it on and note the IP address and port displayed (e.g. 192.168.1.15:5555).

Step 2: Connect Your Computer to the Watch

Open a terminal window (Terminal on macOS/Linux, or Command Prompt/PowerShell on Windows) and run the connection protocols.

For Modern Watches (Wear OS 4 & 5 / Pixel Watch 2+ / Galaxy Watch 6+):

These devices use secure wireless pairing. On the watch, under Wireless debugging, tap Pair new device. Use the pairing port and pairing code shown on your watch screen:

adb pair [IP_ADDRESS]:[PAIRING_PORT]

Type in the pairing code when prompted. Once paired, run the connection command using the standard port from the previous screen:

adb connect [IP_ADDRESS]:[CONNECTION_PORT]

For Older Watches (Wear OS 3 and Below):

If pairing codes are not supported, connect directly via port 5555:

adb connect [IP_ADDRESS]:5555

Look at your watch screen and tap the checkmark to allow debugging authorization from your computer.

Step 3: Side-load the APK File

Once connected, verify the connection is active by checking the connected device list:

adb devices

Your watch's IP and port should appear with the status device. Now, run the install command. Use quotes or provide the absolute path if the file name contains spaces:

adb install "C:\Users\Name\Downloads\app_name.apk"

Depending on the file size and Wi-Fi speed, the transfer may take anywhere from 10 seconds to a minute. Once completed, the terminal will display Success.

Step 4: Optimizing the App UI (Optional but Recommended)

Because many mobile APKs are designed for rectangular smartphone screens, they can look oversized or cut off on circular smartwatch screens. You can fix this by scaling the device's display density (DPI):

For example, if you run adb shell wm density 240, the watch UI elements shrink, allowing you to click buttons that were previously off-screen on the round display boundaries. Once you have navigated past the app's setup screens, you can reset it back using adb shell wm density reset.

How to Uninstall Side-loaded Apps

If you no longer need the application, you can uninstall it directly from the watch by pressing and holding the app icon in the app drawer. Alternatively, you can uninstall it using ADB. First, find the package name of the app:

adb shell pm list packages -3

Locate the app's identifier, then run the uninstall command:

adb uninstall package.name.here

Once you are finished, make sure to navigate back to Developer Options on your watch and disable both Wireless debugging and ADB debugging to preserve battery life and keep your connection secure.