Connecting Galaxy Watch to Watch Face Studio over Wi-Fi

Shamima Nasrin

Engineer, Samsung Developer Program

Watch Face Studio (WFS) is a powerful watch face design tool for Wear OS-based smartwatches that allows you to test watch faces within the tool. However, since most designers prefer testing their watch faces on real devices, WFS also provides the "Run on Device" feature that deploys watch face projects directly to real devices.

The connectivity policies have changed in Wear OS 4. This article describes how to connect a Galaxy Watch running Wear OS powered by Samsung (running Wear OS 4 or later) to WFS over Wi-Fi both through the WFS interface and through the command line interface.

Prerequisites

Prepare the Galaxy Watch for connecting to WFS over Wi-Fi:

  1. Disable Bluetooth on the watch.
  2. Enable Wi-Fi on the watch and connect it to the same network as your computer. The wireless network can be through a router or a mobile hotspot.

    To connect to a Wi-Fi network, go to Settings > Connections > Wi-Fi, check that Wi-Fi is enabled, and select the network to join.

    undefined
    undefined
    undefined
    undefined
    undefined

    Figure 1: Wi-Fi enabled on watch

    undefined
  3. If you have not already enabled Developer mode on the watch, enable it.

    Go to Settings > About watch > Software information and tap the Software version item 5 times.

    undefined
    undefined
    undefined
    undefined
    undefined

    Figure 2: Software version item

    undefined

    You receive a toast notification when Developer mode is enabled. The “Developer options” menu item now can be found below “About watch” on the “Settings” menu.

    undefined
    undefined
    undefined
    undefined
    undefined

    Figure 3: “Developer options” item in “Settings” menu

    undefined
  4. Enable ADB debugging.

    In the “Developer options” menu, toggle the ADB debugging switch on.

    undefined
    undefined
    undefined
    undefined
    undefined

    Figure 4: ADB debugging enabled

    undefined
  5. Enable wireless debugging.

    In the “Developer options” menu, toggle the Wireless debugging switch on.

    undefined
    undefined
    undefined
    undefined
    undefined

    Figure 5: Wireless debugging enabled

    undefined
  6. Retrieve the connection IP address and port.

    When Wireless debugging is enabled, a menu item appears with the watch’s IP address and port. Make a note of this information, as it is needed to connect the watch to WFS.

    undefined
    undefined
    undefined
    undefined
    undefined

    Figure 6: Connection IP address and port

    undefined
  7. Retrieve the pairing code, IP address, and port.

    In the “Wireless debugging” menu, select Pair new device and note the pairing code and port number. You need this information to pair the watch with your computer.

    undefined
    undefined
    undefined
    undefined
    undefined

    Figure 7: Pairing information

    undefined

You are now ready to connect the watch to the computer over Wi-Fi.



Use the Watch Face Studio UI

To connect your watch to WFS for deploying and testing your watch face:

  1. In the top right corner of your project in Watch Face Studio, click Run on Device
    undefined
    undefined
    undefined
    undefined
    undefined

    Figure 8: “Run on Device” in WFS

    undefined
  2. In the “Connected Devices” dialog, to add a new device, click the + button.
    undefined
    undefined
    undefined
    undefined
    undefined

    Figure 9: Adding a device

    undefined
  3. Enter the connection and pairing information that you retrieved from the Galaxy Watch into the appropriate fields.
    undefined
    undefined
    undefined
    undefined
    undefined

    Figure 10: Connecting Galaxy Watch using WFS

    undefined
  4. Click OK.

    The watch is added to the list of connected devices and your project can be launched on the watch.

    undefined
    undefined
    undefined
    undefined
    undefined

    Figure 11: Watch connected to WFS

    undefined

Use the command line

You can also connect the watch to your Watch Face Studio on your computer through the Android Debug Bridge (ADB) command line tool. ADB is integrated into WFS, so a separate installation is not needed.

To pair and connect the watch and computer over Wi-Fi using ADB shell commands:

  1. Open the command prompt or terminal on your computer.
  2. To pair the watch and computer, run the following command with the pairing IP address and port that you retrieved from the watch:

    adb pair <IP address:port>

  3. When prompted, enter the Wi-Fi pairing code.
  4. To connect the watch, run the following command in the terminal with the connection IP address and port that you retrieved from the watch:

    adb connect <IP address:port>

    undefined
    undefined
    undefined
    undefined
    undefined

    Figure 12: Pairing and connection through command line

    undefined
  5. In your WFS project, click Run on Device.

    The watch is in the list of connected devices and your project can be launched on the watch.

Summary

This article has described how you can pair and connect Galaxy Watch running Wear OS 4 or later to Watch Face Studio on your computer wirelessly through Wi-Fi. After connecting your watch, you can deploy and test your WFS project on the watch.

If you have questions about or need help with the information in this article, you can share your queries on the Samsung Developers Forum. For more specialized support, you can contact us through Developer Support.

Preferences Submitted

You have successfully updated your cookie preferences.