GUI Remote Controll
GUI Remote Controll shares a Windows, Linux, or macOS desktop with a web browser. The browser receives screen frames and can redirect mouse, touch, wheel, keyboard, text input, and plain-text clipboard events to the server computer.
Quick Start
Python 3.10 or newer is required.
-
Install the package:
pip install gui-remote-controll -
Start a PIN-protected server:
gui-remote-controll --pin 123456 --title "Office workstation"Startup requests administrator/root privileges once. Use
--no-elevateonly when the desktop permissions have already been configured or elevation is inappropriate. Omit--titleto useGUI Remote Controll. -
Open the control page:
- On the server computer:
http://127.0.0.1:8000 - On the local network:
http://SERVER_LAN_IP:8000
- On the server computer:
The default bind address is 0.0.0.0. Always set --pin when another device can reach the
server. Use TLS or an encrypted tunnel outside a trusted LAN, and never expose the default
HTTP service directly to the public internet.
First-run permissions
- Windows: accept the UAC prompt. Run the server from the signed-in interactive session.
- Linux: use an X11 desktop session. Native Wayland does not permit portable global capture and input injection.
- macOS: grant Screen Recording and Accessibility permissions to the terminal or Python executable, then restart the server. Root access does not replace these permissions.
See the platform guide for setup and troubleshooting details.
Documentation
- Documentation index
- Complete user guide
- CLI reference
- Architecture and algorithms
- Platform support
- Development and release guide
- Changelog
- Security policy
The Python import package is gui_remote_controll. The PyPI distribution and command name
intentionally follow the repository spelling, gui-remote-controll.
License
Metadata
Release files for gui-remote-controll 0.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| gui_remote_controll-0.1.4.tar.gz | 57.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gui_remote_controll-0.1.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 97.8 kB
Release files / gui_remote_controll-0.1.4.tar.gz
| Download URL | gui_remote_controll-0.1.4.tar.gz |
|---|---|
| Size | 57.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
58c3e115186b69198a2471a2312efffcdf56d426490a5ca9fc1c8e02b756aec3
|
|
BLAKE2b-256 checksum How to use checksums |
3dd1286257e9e1af250ebe603d575c740219f1d63010de7aa18b7fe295baab51
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.11.15 Windows/10
|
Release files / gui_remote_controll-0.1.4-py3-none-any.whl
| Download URL | gui_remote_controll-0.1.4-py3-none-any.whl |
|---|---|
| Size | 40.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8d98fcc8a115d0f7fbb8ca3796347a50ca14b0fd213d8910cd3f4dd06a687db1
|
|
BLAKE2b-256 checksum How to use checksums |
5678878ea01100f0c6ad1d5fce8412e80f9d8c6ff095f31e3cd7e4aa19fb73e1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.11.15 Windows/10
|