https://github.com/Evidlo/picklecast

Share your screen to a projector with only a web-browser.
https://github.com/Evidlo/picklecast

raspberry-pi screenshare screensharing webrtc

Last synced: 3 months ago
JSON representation

Share your screen to a projector with only a web-browser.

• Host: GitHub
• URL: https://github.com/Evidlo/picklecast
• Owner: Evidlo
• License: mit
• Created: 2022-06-27T21:45:50.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2024-07-31T01:44:47.000Z (3 months ago)
• Last Synced: 2024-07-31T04:27:46.721Z (3 months ago)
• Topics: raspberry-pi, screenshare, screensharing, webrtc
• Language: JavaScript
• Homepage:
• Size: 2.32 MB
• Stars: 62
• Watchers: 2
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-webrtc - picklecast - Share your screen to a projector with only a web-browser. (Projects / Screen)

README

        
# picklecast - Simple Screen Cast Receiver

Screen share to a RaspberryPi or display computer connected to a projector or TV.

![](screenshot.png)

## Quickstart

Install and start the server on the display computer or RPi:

    $ pip install picklecast

    $ picklecast

    Server address: 192.168.1.100

    Display URL: http://localhost:8443/display   http://192.168.1.100:8443/display

    Client URL: http://192.168.1.100:8443/

    

Then open the display URL in a web-browser on the display computer.  You can now share your screen from a personal device by visiting the client URL.

    

Optionally install as a user service on Linux to keep it running the background:

    picklecast install_service

    systemctl --user daemon-reload

    systemctl --user start picklecast

## How it Works

Picklecast is just a Python program that serves HTML and relays handshake messages between two browsers.  The streaming and displaying is handled in Javascript in the display/client browsers using the WebRTC api.



## Caveats

- Audio sharing only supported when sharing from Chrome on Windows ([bugzilla](https://bugzilla.mozilla.org/show_bug.cgi?id=1541425)).

- Currently there can be only one browser open to the display URL at a time

- Only desktop browsers are supported, as mobile browsers don't support [getDisplayMedia](https://caniuse.com/?search=getDisplayMedia)

- I've had issues getting the WebRTC APIs working correctly with Chrome on Windows.  Help on this issue would be appreciated.