You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Gary dos Santos ecfc2afbba full width 11 months ago
static full width 11 months ago
templates full width 11 months ago
COPYING add copyright and license 12 months ago
README.md add how to terminate 12 months ago
__init__.py add copyright and license 12 months ago
screen.py convert rgba again 11 months ago
screenshare.py add copyright and license 12 months ago

README.md

Description

For some reasons, I wanted to share my computer screen to other computers in the same local network (LAN or WLAN). I could not find an easy way to do it. All free and pricey screen sharing services need the computers in the same local network to connect to the Internet. They incur tremendous network traffic on my Internet connection.

So, I created this small screen sharing tool in Python. All computers in the same local network only need local network connections for screen sharing. Now, I have zero Internet access concerns while I share my screen to all other computers in my network.

In short, the computer to share screen runs this Python script that captures screenshots periodically and hosts screenshots as a streaming web service. Other computers then browse the screenshots with any web browser.

Of course, if you want to share your screen on the Internet, all you need to do is offering this service on the Internet as any other regular services.

Updates:

  • 10/5/2021: Add https to screen sharing

  • 10/4/2021: Add a feature to set a password to control who can access the screens.

Security reminder Do not run this service if you do not need to share screen.

Requirements

This tool can run on Linux, Windows and MAC.

  • Python 2.x or 3.x

  • Know issue: In Linux, this tool does not work with Wayland because of a security reason. You must use Xorg (by selecting Xorg on login).

Install

  1. pip install flask-bootstrap pyscreenshot pyopenssl pillow

  2. In a directory, run "git clone https://github.com/qijungu/screenshare.git". You will have a new directory "screenshare" with code inside.

Run as http

  1. To start the screen sharing service, run "python screenshare.py [-p port] [-w password]".

    The default service port is 18331. Example commands are below.

    # host screenshots on port 18331 and no password

    python screenshare.py

    # host screenshots on port 80 and password "abcdef"

    python screenshare.py -p 80 -w abcdef

    python screenshare.py --port 80 --password abcdef

  2. On other computers, open a web browser and browse "http://serverip:port".

    For example, if the server ip is 192.168.0.101 and the service port is 18331, then the URL to browse is "http://192.168.0.101:18331".

Run as https

  1. (Optional) Create a self-signed certificate and a private key. Or, obtain a signed certificate and private key.

    # openssl req -x509 -newkey rsa:2048 -nodes -out cert.pem -keyout key.pem -days 9999

  2. To start the screen sharing service with https, run "python screenshare.py -s [-p port] [-w password] [-c cert.pem -k key.pem]".

    The default service port is 18331. Example commands are below.

    # host screenshots on port 18331 and no password, https with default built-in certificate and private key

    python screenshare.py -s

    # host screenshots on port 443 and password "abcdef", https with default built-in certificate and private key

    python screenshare.py -s -p 443 -w abcdef

    python screenshare.py -s --port 443 --password abcdef

    # host screenshots on port 18331 and no password, https with a certificate file and a private key file

    python screenshare.py -s -c cert.pem -k key.pem

  3. On other computers, open a web browser and browse "https://serverip:port".

    For example, if the server ip is 192.168.0.101 and the service port is 18331, then the URL to browse is "https://192.168.0.101:18331".

    You will see a warning about the self-signed certificate in the web browser. Accept the warning and continue.

To terminate:

In Linux, press CTRL \  (Control Backslash, not CTRL C)

In Windows, press CTRL Break