Wear OS by Google provides two ways to capture Wear UI screenshots:
- 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.
- Use the companion app - The Take wearable screenshot option in the app lets you take screenshots of Wear UI.
- Choose option 1 to join multiple screens to a single screenshot.
- Choose option 2 for a screenshot of a single screen.
This document describes both options.
Capture screenshots using the Stitch tool
The Wear Stitch tool is an open source Python script available on GitHub at https://github.com/google/android-wear-stitch-script.
Note: You need to verify that your device instances are connected
to an Adb server before using the Stitch tool. You can verify that
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:
- Download the Python script from GitHub (https://github.com/google/android-wear-stitch-script).
- On your computer, open a Terminal window.
- Change to the directory where you saved
- Run the script:
python ./wear_screenshot_stitch.py [--square] [--transparency] [--adb-args ...]
python ./wear_screenshot_stitch.py --square emulator-5544
After the script finishes executing, screenshots are output to the
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-argsparameter in double-quotes. For example:
python ./wear_screenshot_stitch.py --adb-args "-s 127.0.0.1:4444"
Capture screenshots with the companion app
You can use the companion app to capture screenshots of your Wear UI by following these steps:
- On your Wear UI, find the screen that you want to capture.
- On the Android phone, enable Developer options if you haven't already, by going to Settings > About phone, and tapping Build number seven times.
- Open the Wear companion app on your phone.
- Tap the overflow button (three dots in the upper right hand corner) to open the menu.
- Tap Take wearable screenshot. The following dialog appears:
Screenshot request sent.
Then you receive the following notifications: Wearable Screenshot finished and tap to send.
- Tap the notification to receive options for sending or sharing the screenshot via Bluetooth, GMail, etc.