Awesome Open Source
Awesome Open Source



⚠️ Some hidden methods have been called via reflection which may break as Android OS evolves.

An experimental demo for capturing and displaying screenshot of Android devices in the WebBrowser. It's compatible with Android OS 4.0+ and could be used as a convenient tool for taking a batch of screenshots by different image formats && dimensions, reporting bugs and reviewing app features.


Quick start

  • Connect your device/emulator

  • Install the apk

Download and install the prebuilt apk from here or install it directly:

./gradlew clean installDebug
  • Run the script (using for Python 3.6+)
python scripts/

After that, the default web browser will be opened. You should see the screenshot now.

  • (Optional) Specify the target connected device and set the port of ScreenShot service
python scripts/ -p 12346 -s 'your-device-id'

For more info, python scripts/ -h

Use it wirelessly :

  • Get your device IP address (in Settings - System - About phone - Status) e.g : 192.168.x.x
  • Enable adb over TCP/IP on your device: adb tcpip 5555
  • Connect to your device: adb connect 192.168.x.x:5555 (replace 192.168.x.x with the actual IP address)
  • Unplug your device
  • Go through all the steps under Common usage

To switch back to USB mode: adb usb.

Common usage:


Once apk file installed, you can use the python scripts to automate the following adb related operations.

  • Install the apk properly on the phone (Don't install it via Run 'app' from Android Studio).
./gradlew clean installDebug
  • Push the apk to the tmp folder
adb push ${your-project-path}/DroidCast/app/build/outputs/apk/debug/DroidCast-debug-1.0.apk /data/local/tmp
  • Start our internal server process for image processing by app_process
$ adb shell
D1C:/ $ export CLASSPATH=/data/local/tmp/DroidCast-debug-1.0.apk
D1C:/ $ exec app_process /system/bin com.rayworks.droidcast.Main '[email protected]'
>>> DroidCast main entry

  • Please note: On some devices, if you got the error "appproc: ERROR: could not find class 'com.rayworks.droidcast.Main', please replace the above value of CLASSPATH with the result returned by adb shell pm path com.rayworks.droidcast.

  • Use adb forward socket connection from your pc to the connected device
$ adb forward tcp:53516 tcp:53516

Currently png, jpeg and webp, these image types are supported.


vysor 原理以及 Android 同屏方案

scrcpy : Display and control your Android device





Stargazers over time

Stargazers over time


Copyright (C) 2018 rayworks

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Java (705,828
Android (40,443
Websocket (5,251
Python Script (1,385
Screenshot (1,254
Adb (362
Related Projects