RTTP configuration

These Liberator configuration items define how Liberator handles RTTP connections with clients.

Here's a list of all the RTTP-related configuration items:

RTTP connection types

Here's a summary of the RTTP connection types that are referred to in the descriptions of the configuration items below:
 

RTTP connection type Description Can be used in these client types
Type 1

Direct connection

This is a direct persistent connection via TCP/IP. The client connects to the server via a TCP/IP socket, and the server streams data directly to the client across this connection.

  • Java clients 
  • Android clients
  • iOS clients
  • .NET clients
Type 2

HTTP streaming

This is a persistent connection that uses tunneling over HTTP or HTTPS. The client connects to the server by requesting a URL. The server holds the requested page open and streams data to the client until the client closes the connection.

  • StreamLink Java clients
  • StreamLink Android clients
  • StreamLink iOS clients
  • StreamLink.NET clients
  • StreamLink Silverlight clients

Type 3

Polling

The client polls the server for data, issuing a fresh HTTP or HTTPS request each time.
Because the polling mechanism is relatively inefficient and resource hungry, and can increase message latency, it's usually only used as a fallback mode when other types of connection can't be established.

  • StreamLink Java clients
  • StreamLink Android clients
  • StreamLink.NET clients
  • StreamLink Silverlight clients
  • StreamLink JS clients
Type 4 Multipart replace. No longer supported. -
Type 5

Forever frame

This connection type is Intended mainly for use with applications running in Internet Explorer, but it can be used for other browsers if the browser's server-sent events capability has been disabled.

  • Streamlink JS clients
Type 8 HTML 5 web socket
  • StreamLink Java clients
  • StreamLink Android clients
  • StreamLink iOS clients
  • Streamlink JS clients
Type 9 Server-sent events
  • Streamlink JS clients running in the Firefox or Google Chrome browsers 

rttp-hostname

rttp-hostname specifies the hostname that Liberator sends to the client when the RTTP connection is established.

Syntax:

rttp-hostname <hostname>

Type: string

Default value: [none]

rttp-server-name

rttp-server-name specifies the server-name Liberator sends to the client when the RTTP connection is established.​

Syntax:

rttp-server-name​ <server-name>

Type: string

Default value: rttpd/<version> where <version> is the Liberator version.

rttp-type2-url

rttp-type2-url specifies the URL that an RTTP client requests when it wishes to make an RTTP type 2 (HTTP streaming) connection.

Warning! You shouldn't normally need to set this configuration item. Changing it from the default setting is likely to prevent StreamLink clients from communicating with Liberator. 

Syntax:

rttp-type2-url <url-selecting-RTTP-type2-connection>

Type: string

Default value: /RTTP-TYPE2

rttp-type3-timeout

rttp-type3-timeout specifies the timeout in seconds of the HTTP connection for a type 3 (polling) RTTP connection. Each type 3 connection is mapped to a pool of HTTP connections that form the backchannel for a type3 session. An HTTP connection times out after rttp-type3-timeout seconds if there's been no activity on the connection during this period. If this happens, the session remains in place and a new HTTP connection is assigned to it if the activity recommences.

Syntax:

rttp-type3-timeout <<timeout-in-seconds>>

Type: float

Default value: 10.0 seconds

rttp-type3-url

rttp-type3-url specifies specifies the URL that an RTTP client requests when it wishes to make an RTTP type 3 (polling) RTTP connection.

Warning! You shouldn't normally need to set this configuration item. Changing it from the default setting is likely to prevent StreamLink clients from communicating with Liberator. 

Syntax:

rttp-type3-url <url-selecting-RTTP-type3-connection>

Type: string

Default value: /RTTP-TYPE3

rttp-type4-url

rttp-type4-url specifies specifies the URL that an RTTP client requests when it wishes to make an RTTP type 4 (multipart replace) RTTP connection.

Warning! You shouldn't normally need to set this configuration item. Changing it from the default setting is likely to prevent StreamLink clients from communicating with Liberator. 

Syntax:

rttp-type4-url <url-selecting-RTTP-type4-connection>

Type: string

Default value: /RTTP-TYPE4

rttp-type5-pad-length

rttp-type5-pad-length specifies the header padding in bytes for type 5 (forever frame​) RTTP connections.

Syntax:

rttp-type5-pad-length <header-padding-in-bytes>

Type: integer

Default value: 4096 bytes

rttp-type5-sljs-js

rttp-type5-sljs-js specifies specifies the directory path and filename of the JavaScript file for type 5 (forever frame​) RTTP connections used in StreamLink JS. When Liberator receives a request for a type 5 connection from a StreamLink JS client, it serves this Javascript file up to the client, which then executes the code in the file to enable correct operation of the type 5 connection.

Warning! You shouldn't normally need to set this configuration item. Changing it from the default setting is likely to prevent StreamLink clients that use StreamInk JS  from communicating with Liberator. 

Syntax:

rttp-type5-sljs-js <directory-path-and-filename>

Type: string

Default value: /sljs/foreverframe.js

rttp-type5-url

rttp-type5-url specifies specifies the URL that an RTTP client requests when it wishes to make an RTTP type 5 (forever frame​) RTTP connection.

Warning! You shouldn't normally need to set this configuration item. Changing it from the default setting is likely to prevent StreamLink clients from communicating with Liberator. 

Syntax:

rttp-type5-url <url-selecting-RTTP-type5-connection>

Type: string

Default value: /RTTP-TYPE5

rttp-type9-url

rttp-type9-url specifies specifies the URL that an RTTP client requests when it wishes to make an RTTP type 9 (server sent events) RTTP connection.

Warning! You shouldn't normally need to set this configuration item. Changing it from the default setting is likely to prevent StreamLink clients from communicating with Liberator. 

Syntax:

rttp-type9-url <url-selecting-RTTP-type9-connection>

Type: string

Default value: /RTTP-TYPE9

rttp-websocket-url

rttp-websocket-url specifies specifies the URL that an RTTP client requests when it wishes to make an RTTP connection that uses HTML5 web sockets (also known as a type 8 connection).

Warning! You shouldn't normally need to set this configuration item. Changing it from the default setting is likely to prevent StreamLink clients from communicating with Liberator. 

Syntax:

rttp-websocket-url <url-selecting-websocket-connection>

Type: string

Default value: /RTTP-TYPE8


See also: