/Easy-HLS-Website

Super fast, super reliable HLS with NGINX RTMP

Primary LanguageJavaScriptGNU Lesser General Public License v3.0LGPL-3.0

Easy-HLS-Website

Super easy to setup, super reliable, low latency HLS with NGINX RTMP

Getting Started

WARNING WARNING WARNING do NOT run these steps on a server used for anything else!

The fastest way to get started is:

  1. Build out a fresh Ubuntu 20.04 machine or VM (ideally a VM)
  2. Do all the other steps as the root user (NOT sudo!)
  3. cd /root && git clone 'https://github.com/QuinnEbert/Easy-HLS-Website.git' && cd /root/Easy-HLS-Website/easy-installs && chmod +x ./Ubuntu-20.04-Install.sh && ./Ubuntu-20.04-Install.sh
  4. Point OBS to rtmp://the-server-ip-address:1935/live and set the stream key to testuser_testkey
  5. Point your desktop or iOS web browser to http://the-server-ip-address/ and profit

Big Pitfalls

I have not automated the build of the Ubuntu 20.04 FS overlay tarball yet so it may be out of date sometimes versus what's on the repo.

Bonus stuff

The RTMP server will save FLV VODs in /var/lib/rtmp and HLS VODs in /var/lib/rtmp/hls

Future plans

I will be building out a web-based interface that will do all the usual basic stuff you expect for a streaming site.

Credits

Thanks to Dre for boiling the basic process down to a science: View Dre's HLS Guide