Skip to content

Latest commit

 

History

History
162 lines (131 loc) · 7.44 KB

README.md

File metadata and controls

162 lines (131 loc) · 7.44 KB

Restreamer

A really nice and free alternative for handling live streams.

License License Docker pulls Discord Documentation

Try live demo
demo username demo password

Restreamer Promo Video

Self-hosting solution to stream live to your website and publish to many like YouTube-Live, Twitter, Twitch, Vimeo, and other platforms or services. Our Docker-Image is easy to install and runs on Linux environments (MacOS/Windows by Docker Desktop). Moreover, combine the Restreamer with single-board computers like Raspberry Pi or GPU powered systems for Video-Encoding.



Features

  • Simplified User-Interface
  • Easy wizard configuration
  • Multiple audio/video inputs, outputs, protocols, and codecs
  • ReStreaming to platforms such as YouTube-Live, to software such as Wowza Media Server, and others based on protocols such as RTMP, SRT, ...
  • Option to mux a separate audio channel to the video
  • Build-in VideoJS-Player for your Website
  • Configurable publication website for streaming without player embedding
  • Content license with Creative Commons
  • HTTP/S- (HLS), RTMP/S- & SRT-Streaming Server
  • Automatic Let's Encrypt HTTPS certification
  • Viewer/Bandwidth Monitoring and limiting
  • Raspberry Pi (MMAL/OMX), Nvidia Cuda, Intel VAAPI support
  • Support for Hardware- and Virtual-Devices
  • FFmpeg Video-Processing (as native as possible)
  • REST-API (JSON) and 100% Swagger documented
  • Resource Monitoring (optionally by Prom-Metrics)
  • Server- and Process-Logging
  • GDPR compliant without third-party providers and does not save audience data

Quick setup

AMD64/ARMv7/ARM64:

docker run -d --restart=always --name restreamer \
   -v /opt/restreamer/config:/core/config -v /opt/restreamer/data:/core/data \
   -p 8080:8080 -p 8181:8181 \
   -p 1935:1935 -p 1936:1936 \
   -p 6000:6000/udp \
   datarhei/restreamer:latest

--privileged just for local devices like usb cameras.
Try --security-opt seccomp=unconfined if no network source can be reached.

ARMv7/ARM64 Raspberry Pi:

docker run -d --restart=always --name restreamer \
   -v /opt/restreamer/config:/core/config -v /opt/restreamer/data:/core/data \
   --privileged \
   -p 8080:8080 -p 8181:8181 \
   -p 1935:1935 -p 1936:1936 \
   -p 6000:6000/udp \
   datarhei/restreamer:rpi-latest

--privileged just for local devices like usb cameras.
Try --security-opt seccomp=unconfined if no network source can be reached.

AMD64 Nvidia Cuda:

docker run -d --restart=always --name restreamer \
   -v /opt/restreamer/config:/core/config -v /opt/restreamer/data:/core/data \
   --runtime=nvidia --privileged \
   -p 8080:8080 -p 8181:8181 \
   -p 1935:1935 -p 1936:1936 \
   -p 6000:6000/udp \
   datarhei/restreamer:cuda-latest

--privileged just for local devices like usb cameras.
Try --security-opt seccomp=unconfined if no network source can be reached.

AMD64 Intel VAAPI:

docker run -d --restart=always --name restreamer \
   -v /opt/restreamer/config:/core/config -v /opt/restreamer/data:/core/data \
   -v /dev/dri:/dev/dri --privileged \
   -p 8080:8080 -p 8181:8181 \
   -p 1935:1935 -p 1936:1936 \
   -p 6000:6000/udp \
   datarhei/restreamer:vaapi-latest

--privileged just for local devices like usb cameras.
Try --security-opt seccomp=unconfined if no network source can be reached.

For external access (http/s, rtmp/s, srt), port forwarding from your Internet-Router to the Restreamer's internal IP address may need to be set up.

Documentation

Documentation is available on docs.datarhei.com/restreamer. We give many pieces of information, from setting up a camera, embedding your player upon your website, and streaming to services like, e.g., YouTube-Live, and many more.

Development

Create a custom image (bundle):

$ git clone github.com/datarhei/ffmpeg
$ cd ffmpeg
$ docker build -f Dockerfile.alpine -t myffmpeg .
$ git clone github.com/datarhei/core
$ cd core
$ docker build -t mycore .
$ git clone github.com/datarhei/restreamer-ui
$ cd restreamer-ui
$ docker build -t myrsui .

Restreamer bundle:

$ git clone github.com/datarhei/restreamer
$ cd restreamer
$ docker build --build-arg FFMPEG_IMAGE=myffmpeg --build-arg CORE_IMAGE=mycore --build-arg RESTREAMER_UI_IMAGE=myrsui -t myrestreamer .
$ docker run -it --rm -p 8080:8080 myrestreamer

To add/fix translations in the Restreamer interface:

The Restreamer interface is currently translated in different languages, such as German, French, Italian, Spanish, and more. If you find errors in the translations or have better suggestions for some sentences, you can become a translation contributor on poeditor.com. There you can also start a translation into a language that is not yet available in the Restreamer interface.

Contribute to the translations on: https://poeditor.com/join/project/ogATl3F48K

Community support

For general help using Restreamer, please refer to the official documentation. For additional support, you can use Github to ask a question (Bug reports, Contributions, Features).

License

See the LICENSE file for licensing information.

Business inquiries

We provide support for commercial requirements with professional support, agile software development, and consulting. If you have a commercial request, be it a bug or a feature enhancement, please contact us directly at support@datarhei.com.