https://github.com/oldweb-today/remote-desktop-server

A set of Docker images for streaming a remote desktop video and audio
https://github.com/oldweb-today/remote-desktop-server

Last synced: 3 months ago
JSON representation

A set of Docker images for streaming a remote desktop video and audio

• Host: GitHub
• URL: https://github.com/oldweb-today/remote-desktop-server
• Owner: oldweb-today
• License: apache-2.0
• Created: 2019-01-11T06:57:53.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2023-05-15T07:18:31.000Z (over 1 year ago)
• Last Synced: 2024-06-29T09:33:48.696Z (4 months ago)
• Language: Python
• Size: 6.96 MB
• Stars: 26
• Watchers: 2
• Forks: 8
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Remote Desktop Server Contains for Webrecorder/oldweb.today

This repository represents the remote desktop system used by Webrecorder and new oldweb.today

to stream the display and audio from remote browsers.

In Webrecorder/OWT, the system is used to stream contents of web browsers but can apply to any Linux desktop application.

## Desktop Streaming Options

The system provides several connection options for streaming a Linux desktop and audio using VNC and WebRTC.

The options are:

- Full WebRTC: Streaming desktop via WebRTC connection (H264 or VP8) and audio (Opus).

- VNC Video + WebRTC Audio: Streaming desktop via VNC and audio using WebRTC (Opus).

- Vnc Video + WS Audio: Streaming desktop via VNC and audio stream over a WebSocket connection (either MP3 or OPUS)

The `oldwebtoday/remote-desktop-server` supports options for all three and the method can be determined at runtime via the client.

The system is designed to work with an in-browser client, which can determine which connection method to use.

See [oldweb-today/shepherd-client](https://github.com/oldweb-today/shepherd-client) for more info.

## Architecture

The system is comprised of two Docker containers:

- `oldwebtoday/base-displayaudio`: This container sets up the base infrastructure, installing GStreamer, x11vnc, Python, etc.. necessary for streaming

- `oldwebtoday/remote-desktop-server`: This container sets up a Python based media controller, which receives messages via WebSocket. The controller acts

as a signalling server to set up the WebRTC connection. When using streaming audio, it transmits audio packets directly over the WebSocket.

When using VNC, the x11vnc server is used with websockify to transmit VNC data over a separate websocket.