Skip to content

Most visited

Recently visited


Capturing Wear UI Screenshots

Wear OS by Google provides two ways to capture Wear UI screenshots:

  1. Use the Wear Stitch tool - Wear Stitch is a tool for capturing screenshots of watch UIs from a Wear device or the emulator. It takes multiple screenshots that are too tall to fit on the screen at once and joins them together.
  2. Use the companion app - The Take wearable screenshot option in the app lets you take screenshots of Wear UI.

This document describes both options.

Capturing screenshots using the Stitch tool

The Wear Stitch tool is an open source Python script available on GitHub at

Note: You need to verify that your device instances are connected to an Adb server before using the Stitch tool. You can verify that by executing adb devices from the android_sdk/platform-tools/ directory. If connected, you'll see the device name listed as a "device."

To take a screenshot using the Stitch tool:

  1. Download the Python script from GitHub (
  2. On your computer, open a Terminal window.
  3. Change to the directory where you saved
  4. Run the script:

    python ./ [--square] [--transparency] [--adb-args ...]

    For example:

        python ./ --square emulator-5544

After the script finishes executing, screenshots are output to the screencaps/ directory.

Figure 1. Sample screenshots captured with Stitch tool.


The following list shows the options you can use with the Stitch tool:

Assumes device has a square screen (otherwise a circular screen is assumed).
Use alpha transparency for pixels around the corners of the output that the circular screen chops off.
Any arguments following this are directly passed to adb.

Note: Make sure to enclose the arguments following adb-args parameter in double-quotes. For example: python ./ --adb-args "-s"

Capturing screenshots with the companion app

You can use the companion app to capture screenshots of your Wear UI by following these steps:

  1. On your Wear UI, find the screen that you want to capture.
  2. On the Android phone, enable Developer options if you haven't already, by going to Settings > About phone, and tapping Build number seven times.
  3. Open the Wear companion app on your phone.
  4. Tap the overflow button (three dots in the upper right hand corner) to open the menu.
  5. Tap Take wearable screenshot. The following dialog appears: Screenshot request sent.

    Then you receive the following notifications: Wearable Screenshot finished and tap to send.

  6. Tap the notification to receive options for sending or sharing the screenshot via Bluetooth, GMail, etc.

Figure 2. Sample screenshots captured with companion app.

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields


Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience. (April 2018 — Developer Survey)