NGINX RTMP Streamer https://videon.kmlabz.com/
Go to file
Torma Kristóf fd182b6baf
continuous-integration/drone/push Build is failing Details
copy nginx sample configs
2020-09-19 21:55:02 +02:00
.drone.yml add drone config 2020-09-19 21:51:43 +02:00
Dockerfile copy nginx sample configs 2020-09-19 21:55:02 +02:00
README.md first commit 2020-09-19 21:46:46 +02:00
nginx_ingest.conf first commit 2020-09-19 21:46:46 +02:00
nginx_restream.conf first commit 2020-09-19 21:46:46 +02:00
startscript.sh copy nginx sample configs 2020-09-19 21:55:02 +02:00

README.md

NGINX Streamer

NGINX Streamer is a simple to use and lightweight RTMP ingest or restream tool. It can distribute streams to multiple proviers or copy a stream to another local endpoint you can then view live.

Requirements

NGINX Streamer only requires an OCI compatible container runtime to run.

For example typing docker run registry.kmlabz.com/videon/nginx-streamer into your terminal should do the trick.

Environment Variables

If there are no environment variables present, NGINX Streamer stars in ingest mode and generates a stream key for you.

  • TYPE - May be ingest or restream
  • STREAM_KEY - May be an alphanumeric string
  • PUSH_URLS - May be a list of rtmp endpoints to restream to. For example: rtmp://live-fra02.twitch.tv/app/{stream_key}, rtmp://a.rtmp.youtube.com/live2. This environment variable is only relevant in restream mode.

Operating Modes

Ingest Mode

Takes an RTMP stream at rtmp://<yourIP>/origin/<streamKey> and exposes the exact same stream at rtmp://<yourIP>/live.

Restream Mode

The input RTMP stream at rtmp://<yourIP>/origin/<streamKey> will be pushed to the specified RTMP endpoints.

Ports

NGINX Streamer exposes the default RTMP port, 1935. You may forward this to any port on your machine.

TODO

Currently, NGINX Streamer does not validate stream keys. This may be implemented in Django, for example.