Skip to main content

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.

  1. Install the package:

    pip install gui-remote-controll
    
  2. Start a PIN-protected server:

    gui-remote-controll --pin 123456 --title "Office workstation"
    

    Startup requests administrator/root privileges once. Use --no-elevate only when the desktop permissions have already been configured or elevation is inappropriate. Omit --title to use GUI Remote Controll.

  3. Open the control page:

    • On the server computer: http://127.0.0.1:8000
    • On the local network: http://SERVER_LAN_IP:8000

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

The Python import package is gui_remote_controll. The PyPI distribution and command name intentionally follow the repository spelling, gui-remote-controll.

License

MIT

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)

Source distribution for gui-remote-controll 0.1.4
File Size Uploaded
gui_remote_controll-0.1.4.tar.gz 57.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for gui-remote-controll 0.1.4
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

0.1.4 This release

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page