The LIVE555^TM Proxy Server

The "LIVE555 Proxy Server" is a unicast RTSP server - built from the "LIVE555 Streaming Media" software - that acts as a 'proxy' for one or more 'back-end' unicast or multicast RTSP/RTP streams (i.e., served by other server(s)).

The key feature of a proxy server is that it reads each 'back-end' stream only once, regardless of how many separate clients are streaming from the proxy server. This makes the proxy server ideal, for example, for streaming from a RTSP-enabled video camera (which might not be able to handle more than one connection at a time).

                                                              --> [RTSP client1]
        [back-end RTSP/RTP stream] --> [LIVE555 Proxy Server] --> [RTSP client2]
                                                              ...
                                                              --> [RTSP clientN]

Basic operation

The "LIVE555 Proxy Server" is a command-line (i.e., 'console') application. The simplest way to run it is to type:

        live555ProxyServer <url>

where <url> is a RTSP URL (i.e., beginning with "rtsp://") of a 'back-end' stream (e.g., from a video camera). After starting up, the server will display its own "rtsp://" URL for the proxy stream. RTSP clients can then use this URL to play (i.e., receive) the proxy stream.

The server can act as a proxy for many 'back-end' streams - not just one. If you enter more than one "rtsp://" URL on the command line, i.e.,

        live555ProxyServer <url1> <url2> ... <urlN>

then the server will - after starting up - display "rtsp://" URLs for proxying each one. (Of course, you should proxy multiple streams only if you have sufficient network bandwidth to receive all of them.)

Verbose (debugging) output

To display additional output, showing the basic operation of the server, add the "-v" option, before the "rtsp://" URLs. To display even more output - including the RTSP protocol exchange between the proxy server and each of the 'back-end' servers - use the "-V" (i.e., upper-case "V") option instead. (If you are having trouble with the proxy server, then we recommend using the "-V" option to try to figure out what's wrong.)

Back-end streaming over TCP

By default, the proxy server will ask to receive each 'back-end' stream via UDP (i.e., receiving RTP and RTCP packets as UDP datagrams). Sometimes, however, the 'back-end' server may be behind a firewall that blocks UDP packets. To overcome this, you can use the "-t" option to request that each 'back-end' RTSP server stream RTP and RTCP data packets over its TCP connection, instead of using UDP packets. (Note that not all RTSP servers support TCP streaming, and that TCP cannot be used to receive multicast streams.) You should use this option only if you are unable to receive UDP packets, because streaming over TCP can cause incoming data to be excessively delayed.

Alternatively, you can use the "-T <http-port-number>" option to request that each 'back-end' stream be sent (using TCP) over a "RTSP-over-HTTP tunnel", using the specified HTTP port number. RTSP-over-HTTP tunneling can be useful if you are behind a HTTP-only firewall. (Note, however, that not all 'back end' RTSP servers will support this.)

Note: The "-t" and "-T <http-port-number>" options apply only to the 'back-end' stream(s). They do not affect the 'front-end' streams from the proxy server to (potentially multiple) RTSP clients. Those streams can be over either UDP or TCP, depending upon what each client requests.

Proxying access-controlled streams

Some 'back-end' RTSP servers require user authentication (via a user name and password) before you can access their stream. If you add the "-u <username> <password>" option to the proxy server, then it will use this <username> <password> pair - if necessary - to access each 'back-end' stream. (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 'back-end' servers will accept this type of URL.)

Note that it is also possible to provide access control to the proxy server itself - i.e., from 'front-end' RTSP clients. (This, however, is not done from the command line; instead, it is done by modifying the source code of the proxy server. Note the code enclosed by

#ifdef ACCESS_CONTROL
#endif

in "live555ProxyServer.cpp".

Source code, and support

Because this application is intended for computer networking professionals rather than casual end users, we do not make it available as a pre-built binary. Instead, you must build it yourself, from source code. To do so, you must download and build the "LIVE555 Streaming Media" software. Note that the "LIVE555 Proxy Server" application is included in the "proxyServer" subdirectory.

Support for the "LIVE555 Proxy Server" (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.