guiscrcpy Is used for PyQt5 GUI scriptThis is a free open source application for displaying and controlling Android devices connected via USB or wirelessly from a desktop (whether Linux, Windows or Mac).
scrcpy focuses on performance and quality and can provide 30 ~ 60 FPS, high resolution and low latency. A quick list of scrcpy functions:
- Configurable screen resolution and bit rate
- Crop (so you can only show part of your Android device screen if you want)
- Full Screen Android Mirror
- It can record screen while mirroring
- It can show physical touch (with your finger on the device)
- Read-only mode (disable all controls, such as input keys, mouse events, etc.)
- Copy Android device clipboard to computer and from computer to Android
- Keyboard shortcuts
- It supports launching multiple instances with multiple Android devices simultaneously
Only command line options and keyboard shortcuts can be used to control scrcpy. This is what guiscrcpy is for-it exposes the scrcpy cli logo and keyboard shortcuts to the graphical user interface, so you can use buttons to quickly perform actions on a remote Android device, such as copy and paste from one device to another, enter Full screen, switch between portrait and landscape, and more.
See also: Controlling Android devices from the desktop using scrcpy (Ubuntu, Fedora, Debian, Linux Mint installation) guiscrcpy runs on Windows and Linux, it can also run on macOS, but developers cannot test or compile the device , So if you own a Mac, you must run it from source
The guiscrcpy user interface consists of 3 parts:
- The main UI controller, which includes the scrcpy command line flags as options that can be enabled or disabled before starting scrcpy, such as always on top, keep display off, full screen display, record screen, change bit rate or screen resolution, and start scrcpy
- Toolbox UI controller, which is a floating panel that exposes scrcpy functions, which can only be used as keyboard shortcuts, such as opening or closing the Android notification drawer, copying the clipboard from one device to another, Increase or decrease volume, key menus such as home, back and back etc.
- The bottom panel controller is another floating panel, but this only exposes the basic Android controls: power, menu, homepage, back and up or down volume
This scrcpy helper GUI launches scrcpy in its own separate window, and you can move 2 floating panels (always on top) next to it for quick access.
Using guiscrcpy does not mean that you cannot use the built-in scrcpy keyboard shortcuts-you can continue to use these shortcuts, if you don’t want to remember all the keyboards, guiscrcpy will only make it easier for you to access these features with your mouse. It supports shortcuts.
First, you need to install scrcpy and work on your system. I’ve covered how to install scrcpy on Linux from Linux packages and source packages (on Debian, Ubuntu, Linux Mint, or Fedora), so if you don’t have scrcpy installed on your system, please visit these articles. Also visit the official Security Settings Instructions.
After ensuring that scrcpy is compatible with desktop and Android devices, run guiscrcpy. You will notice a main window and 2 floating panels. Enable or disable any options you need from the main guiscrcpy interface and press
START SCRCPY Button.
This will launch the scrcpy window independently of guiscrcpy. You need to move the 2 guiscrcpy floating panels next to the scrcpy window for quick access (as shown in my screenshot). Each button on the floating panel has a tooltip explaining its function. If you don’t see the tooltip, make sure the panel is focused before placing the mouse cursor on top of the buttons on the floating panel.
After starting scrcpy, you can close the guiscrcpy main window because it is no longer needed (unless you want to start scrcpy again later) and both floating panels will continue to work.
It’s worth noting that on my Ubuntu 19.04 system, I can’t move the guiscrcpy panels by dragging with the left mouse button (these panels have a 4-point area that you can use to easily move them). Instead, I have to hold down the charms (on some systems you need to use Alt instead) and then drag the panel with the left mouse button. However, this may be specific to my configuration, so it may only happen in some cases.
Another thing worth mentioning is that if you are using a pre-built guiscrcpy binary, the clipboard copy function will not work (it will work if you run it from source). Also, the zoom in / out button is currently unavailable in pre-built binaries and when running guiscrcpy from source.
Remember: you need a feature script Before using guiscrcpy, please install it on your desktop.
Edit: For the latest guiscrcpy version, there are no longer precompiled Linux binaries for Linux. To install it on Linux, you need to use python3-pip:
python3 -m pip install --user PyQt5==5.14 python3 -m pip install --upgrade --user guiscrcpy
This will install guiscrcpy in
~/.local/bin/ So make sure the directory is in your
PATH. If not, add
PATH="$PATH:$HOME/.local/bin" Give you
~/.bashrc File (default on most systems) or
~/.zshrc (If using Zsh).
When done, open a new terminal (hence the new path) and launch guiscrcpy from that terminal using the following command:
You may also need to read Possible problem And solutions section.