nikp123 / scrcpy-desktop

Run an Android desktop environment off of a device using ONLY scrcpy

For this to work you'll need to do the following:

1. Have a proper USB cable that works (or a good Wi-Fi for use with ADB wireless)
2. Have a PC that is ABLE to process real-time video
3. Make sure that the connection is good (USB or Wi-Fi)
4. Android 10 (MINIMUM) running on the device
5. Developer mode enabled
6. Your PC MUST have ADB access to your phone
7. ADB and SCRCPY installed on your PC
8. Proper binutils (for now) on the Android device

How to do it

On Android device

Install Taskbar.

If you don't you'll automatically get redirected to the Play Store page of that app.

On Linux

Just run startscreen.sh, it should do all the magic itself.

NOTE: It may or may not prompt you to restart your device, which you have to do for a one-time setup. After that, you no longer need to do (unless you change that particular option under developer settings)

Changing options

When running the startscreen.sh script you can change the resolution and DPI via command-line arguments, for example: ./startscreen.sh 1920x1080 120

On Windows

1. Download this repo and extract the contents.
2. Inside this repo, create a folder named bin.
3. Download scrcpy and extract it's contents so that the .exe files are located within the bin folder and not as an sub-folder.
4. Open the extracted repo folder within explorer.
5. Type powershell within the address bar and press enter
6. Type .\startscreen.ps1 -Resolution widthxheight -DPI your_desired_dpi and press enter.
7. If Windows bothers you with a prompt talking about trust, press R to run the script.
8. Enjoy.

Troubleshooting

If after running the script all you get is a black screen, that means that the Android OS that you're running is missing a "desktop launcher". This can be fixed by installing it, for example Taskbar.

If you have trouble getting audio to work. See:

• Genymobile's wiki page
• Issue #15

Virtual keyboard pops up when I use this script!

In case the virtual keyboard pops up when you use this script, install No Keyboard: Hideable keyboard and enable as an input layout it within your language settings. This should prevent that from happening.

Limitations

• A very botched implementation ATM
• The Windows version has no way to automatically obtain the resolution

Credits:

https://github.com/Genymobile/scrcpy - The magic that made this possible

https://github.com/reversegear/scrcpy-pi-omx - Where this idea came from and what the code was inspired by