mjpeg-relay is a simple Python script which accepts input from an existing MJPEG stream, and relays it to any number of clients. This is intended for a scenario where the original MJPEG stream is hosted on a low-bandwidth internet connection (such as a home connection) or from a low-resource device (such as a Raspberry Pi or IP camera), and you have a server from which you wish to relay the stream to multiple clients without placing extra demand on the original stream.
The script is designed to be simple to use with minimal configuration. All video parameters are defined by the source stream, ensuring mjpeg-relay is as transparent as possible. Rather than creating its own MJPEG stream, mjpeg-relay simply re-streams the original MJPEG stream directly. This is a faster and more transparent approach.
Python 3.6+ is required.
- Low resource
- Low latency
- Status page
- Option to stream to clients via WebSockets
- Clone this repository with
git clone <URL> - Ensure dependencies are correctly installed by running
pip install -r requirements.txt
relay.py [-p <relay port>] [-w <WebSocket port>] [-q] [-d] stream-source-url
- -p <relay port>: Port that the stream will be relayed on (default is 54321)
- -w <WebSocket port>: Port that the stream will be relayed on via WebSockets (default is 54322)
- -q: Silence non-essential output
- -d: Turn debugging on
- stream-source-url: URL of the existing MJPEG stream. If the stream is protected with HTTP authentication, supply the credentials via the URL like so:
http://user:password@ip:port/path/to/stream/
Once it is running, you can access the following URLs:
/status: the status summary of mjpeg-relay/stream: the MJPEG stream. This can be embedded directly into an<img>tag on modern browsers like so:<img src="http://localhost:54321/stream">/snapshot: the latest JPEG frame from the MJPEG stream
Situation: Relaying MJPEG stream at 192.0.2.1:1234/?action=stream on port 54017
- Start the relay:
python relay.py -p 54017 "http://192.0.2.1:1234/?action=stream" - Confirm that mjpeg-relay has connected to the remote stream
- Connect to the relayed stream at
http://localhost:54017/stream. This can be embedded directly into an<img>tag on modern browsers like so:<img src="http://localhost:54017/stream"> - The status of mjpeg-relay is displayed at
http://localhost:54017/status
As above, but also relaying the MJPEG stream via WebSockets on port 54018
- Start the relay:
python relay.py -p 54017 -w 54018 "http://192.0.2.1:1234/?action=stream" - Confirm that mjpeg-relay has connected to the remote stream
- Copy and paste the example HTML and JavaScript in the file
websocketexample.htmlinto your website, and adapt as necessary - The status of mjpeg-relay is displayed at
http://localhost:54017/status
Docker image which all the scripts in this repository is preinstalled on python:alpine
Built from master branch
- URL of the source of the stream, in form of
http://user:password@ip:port/path/to/stream/. - DEFAULT
http://localhost:8081/?action=stream
| Option | Port# | Type | Service |
|---|---|---|---|
| Required | 54321 | tcp | Relayed stream is shown through this port. |
| Optional | 54322 | tcp | Relayed stream via WebSocket is shown through this port. |
docker build -t IMAGE_NAME .
docker run -it -p 54017:54321 -e "http://192.0.2.1:1234/?action=stream" IMAGE_NAME