Last week, we introduced our new open source project: scrcpy.
The feedbacks were amazing, many people were interested in the application. ? This was very motivating, and a lot of work has been done in the last few days to fix important issues.?
For example, mouse clicks now work on LG devices, a memory leak and a segfault on copy/paste have been fixed.
For convenience, we also added some mouse shortcuts?:
• middle-click presses the HOME button,
• right-click presses the BACK button (on turn the screen on),
• double-click on black borders resize the window to fit the device screen.
But a specific feature was much requested: make it work over Wi-Fi.
The application communicates with the device over adb, so it should be easy to make it work wirelessly: Connect to a device over Wi-Fi.
It was not counting on an adb bug preventing
adb reverse to work over a connection established by
Therefore, we implemented a workaround to fallback using
adb forward (and reversing the client/server roles) when
adb reverse fails.
How to run scrcpy wirelessly?
Here are the steps:
1. Connect the device to the same Wi-Fi as your computer
2. Get your device IP address (in Settings → About phone → Status)
3. Enable adb over TCP/IP on your device:
adb tcpip 5555
4. Connect to your device:
adb connect DEVICE_IP:5555 (replace
5. Unplug your device
6. Run scrcpy as usual
To switch back to USB mode:
As expected, the performances are not the same as over USB.
The default scrcpy bit-rate is 8Mbps, which is probably too much for a Wi-Fi connection. Depending on the use case, decreasing the bit-rate and the resolution may be a good compromise:
scrcpy --bit-rate 2M --max-size 800
For people in a hurry:
scrcpy -b2M -m800
Note that while it now works over TCP/IP, this is not an optimal solution for streaming a video wirelessly, since the raw stream is still sent over TCP, where a packet loss is very bad for latency, due to head-of-line blocking. But it’s better than nothing!
Under good conditions, it may work pretty well:
On the video, scrcpy is started over USB on the laptop with Debian (on the right), and over Wi-Fi on the Mac (on the left).
You can now build, install and run the new version!