The LIVE555TM HLS Proxy

The "LIVE555 HLS Proxy" is an application - built from the "LIVE555 Streaming Media" software - that allows a web browser to view a 'back-end' (unicast or multicast) RTSP/RTP stream (e.g., from a network camera). An arbitrary number of web browser clients can view the stream, but the back-end RTSP stream is accessed only once.

                                                                        --> [HTTP (web browser) client1]
        [back-end RTSP/RTP stream] --> [LIVE555 HLS Proxy] [Web Server] --> [HTTP (web browser) client2]
                                                                        ...
                                                                        --> [HTTP (web browser) clientN]

Specifically, the "LIVE555 HLS Proxy" converts a live RTSP stream (e.g., from a network camera) into a set of HLS ("HTTP Live Streaming") segments that can be viewed in a HLS-compliant browser (e.g., "Safari" on Macs or iPhones).

(Note the difference between the "LIVE555 HLS Proxy" and the "LIVE555 Proxy Server", where all access to the stream is via RTSP. In contrast, the "LIVE555 HLS Proxy" allows client to access the stream using a web browser.)

To use the "LIVE555 HLS Proxy", you must have a web server (e.g., Apache) running on the same computer.

Basic operation

• "cd" to a directory that's accessible by your web server (e.g., /usr/local/www/apache24/data )
• Run:

      <path-to-live555-software>/live/hlsProxy/live555HLSProxy <rtsp://-url-of-your-RTSP-stream> <HLS-prefix>
    

  where <HLS-prefix> is a name to give to your stream (as seen by web browser users).
• If your RTSP stream is password protected, you can add the "-u <username> <password>" option. (To specify an empty password, use "" for <password>.)

  Alternatively, you could try including the user name and password inside the "rtsp://" URL, as: "rtsp://<username>:<password>@<hostname>:<etc.>". (This is not recommended, however, because - in this case - the password will be sent in the clear over the Internet. Also, not all RTSP servers will accept this type of URL.)

• If you wish to receive the RTP/RTCP data over TCP (the RTSP control connection), you can do so by adding the "-t" option. (As always, you should use this only if there is a firewall - between you and the RTSP server - that blocks UDP packets.)
• Note that you can run the "live555HLSProxy" application several times concurrently - for different input RTSP streams - with different <HLS-prefix>es.
• Once the application has read its first segment of data (about 6 seconds worth), it will 'beep' to let you know that the stream is now available for viewing by web browsers.
• HLS-compatible web browsers will then be able to view the stream via the HTTP (or HTTPS) URL:

      <URL-of-your-web-server>/<HLS-prefix>.m3u8
    

Proxying an 'advertised' RTSP streams

• <port-number> specifies the port number on which the proxy will receive the RTSP "REGISTER" command. If this is omitted, then the proxy will choose its own port number.
• As a special feature - if the "reuse_connection" parameter was set in the "REGISTER" command's "Transport:" header - the HLS proxy gets to reuse the TCP connection on which it received the "REGISTER" command. This can be useful if the RTSP server is behind a firewall or NAT, but the HLS proxy is run on the public Internet. (In this case, you may also wish to use the -t option, to request that the back-end RTSP server also send its RTP/RTCP packets on this same TCP connection.)
• "REGISTER" is a custom RTSP command, developed by Live Networks, Inc. It is currently non-standard, but is described in an IETF Internet-Draft.
• If you use the "-R" option, then you should also use the "-U <username> <password>" option, which specifies a username and password that should be used to authenticate the incoming "REGISTER" command. (Note the difference between the '-u' command, which specifies a username and password to be used for accessing the back-end RTSP stream, and the '-U" command, which specifies a username and password to be used to authenticate incoming "REGISTER" commands.)
• The application "registerRTSPStream" - included in the "testProgs" directory - can be used to 'register' a back-end RTSP stream with a HLS proxy.

Source code, and support

Support for the "LIVE555 HLS Proxy" (and the rest of the "LIVE555 Streaming Media" code) is provided via our developers' mailing list: "live-devel@lists.live555.com". Note that you must first subscribe to the mailing list before you can post to it; please also read the FAQ before posting to the mailing list.