guiscrcpy v1.9.5
GUIscrcPy
A full fledged GUI integration for the
most award winning open-source android
screen mirroring system -- scrcpy
located on https://github.com/genymobile/scrcpy/
by @rom1v
GUIScrcPy is a Python 3.7 based script (haven't tested compatibility issues
so far, but it does not work on Python 3.8 because of incombatibility og PyAutoGUI module)
Why GUIscrcPy?
I had Python as a subject for Class XI, so as a part of it's advanced learning experience,
and because of my daily use of scrcpy, wanted to integrate GUI into the CLIbased app!!
GUI stands for Graphical User Interface, and Py is not inherited from scrcpy but rather from Py for Python
Contents
The package includes two codelets:
Main UI controller
it is the UI system that executes the fixed command to scrcpy engine. These are static.
Toolkit UI controller
It is the UI controller, which gives commands to the Scrcpy window to execute certain actions.
Read Issues and Future Releases , before proceeding
Installation
Linux
Before everything, make sure you have scrcpy on your path.
To install it prehand on linux distributions supporting snap
. Provide this command to terminal
$ snap install scrcpy
.
This will make your life easy on Linux
- (Also called Step 0). Put a star on my repo. Gives support to #opensource!!
- If your OS is Linux-based, to use Toolkit, you need to install
wmctrl
andxdotool
. These are optional to run the toolkit. - Run
guiscrcpy
by right-clickrun
through GUI explorer or add guiscrcpy to path and useguiscrcpy
command to run it.
NOTE : Only Scrcpy 1.9
Windows
On Windows, running guiscrcpy is easier for end-users. just download the exe-installer, and it will automatically install this for you.
scrcpy
(21.4 MB) by @rom1v is already packaged by guiscrcpy
due to 'PATH` problems.
- Run
guiscrcpy-installer.exe
from the Releases - Follow on-screen instructions. A Windows Tile will be added to the Start Menu automatically
NOTE: Toolkit is incompatible on Windows, due to development problems in Windows.
Dependencies
To use toolkit (on Linux only), run:
sudo apt install wmctrl xdotool
[mostly wmctrl and xdotool are packaged along with linux distro]
NOTE : The other tools are packaged with the binary pkg as tar.xz below
Changelog
Build 1.9.5
25062019 2159
- MEGA CHANGE :: Migrated from
PyQt4
toPyQt5
due to late realization that PyQt4 support
for Windows is unfortunately discontinued. mainwindow.ui
>> xml parsed file loaded in uic loader has been compiled tomainui.py
as UI- toolkit.py is deprecated. toolkit class is restructured into mainwindow class with multiprocesing.
- After
PyQt5
update, GTK-LTK-KDE no longer raises pixmap errors - Unreleased *.ui files for Build. Only dependencies for release are png pixmap files
Build 1.9.4
23062018 1615 GMT+300
- Dumped terminal QTextEdit for multiprocessing to prevent QThread hang.
- Restructured StartScrcpy Class as two threads.
Build 1.9.3
22062019 1948 GMT+3
- Fixed GUI hang (issue reported by @rom1v)
(code has been restructured. the old code is placed in/backup/
folder asmain 1.9.2.py
. But however, terminal ui QTextEdit
is not functional.
Build 1.9.2
21062019 2000 GMT+3
- Added GUIScrcpy icon
- Added pixmap icons
- Added check scrcpy process running or not
- Added GUIScrcpy Toolkit Experimental Support
###1.9.1 - Initial Build :)
Future Releases
Surely, this is an initial build with great scope of improvement. Compared to paid Screen Mirroring software, scrcpy gives
a lot of advantages, but my future plans are as follows
Fix HOME_key, BACK_key.(Will have to wait until @rom1v examines my work)- Add better UI support with adb functions out of scrcpy
- Support python3.8 with PyAutoGUI support. Most of the project is based on PyAutoGUI, which is based on Windows, with less support for Linux.
I am on Linux, so i can't test them out, except WINE - Add service running indicator
Issues
There are problems with the toolkit in executing certain functions like HOME key and BACK key. I am not able to solve this on
Linux because of the Xlib Graphics manager. On Windows, it should work properly,
but however, this hasn't been tested so far. I would like to know the results on [email protected]