Skip to main content
Skip table of contents

Configuration

Create settings.json

After installation rename the file "settings template.json" to "settings.json" and customize it according to this documentation.

Configure settings.json

It is important that the file is formatted in valid JSON and contains the following values.

Value

Description

TypeRequired

host

Address to the TurboPlayerService.

Note: It must also contain the WebSocket port to use. The WebSocket port can be configured in the parameters of TurboPlayerService in “WebsocketPort”. By default it is 8091.

URL as Stringyes

audioStreamURL

The URL to be used for prelistening audio files. This should be the base address and the port of TurboPlayerService which is also used for retrieving the web page and for REST calls. You need to append “/turbo/PrelistenFile/%@” whereas the last part is a placeholder for the element ID.

URL as Stringyes

waveformURL

The URL to be used to receive a waveform file. This should be the base address and the port of TurboPlayerService which is also used for retrieving the web page and for REST calls. You need to append “/turbo/WaveFormFile/%@” whereas the last part is a placeholder for the element ID.

URL as Stringyes
rtfQuillDeltaURLThe URL to be used to fetch the Quill Delta of a RTF file. This should be the base address and the port of TurboPlayerService which is also used for other REST calls. You need to append “/turbo/RtfQuillDelta/%@” whereas the last part is a placeholder for the element ID. (Requires TurboPlayerService version 1.3.70.0 or later)URL as Stringno

maxPrelistenCache

Number of files cached for prelistening in the browser. A higher number improves user experience at the cost of bandwidth and memory.

Default value: 20

Integeryes

prelistenEndOffset

Offset for prelistening the end of an element in seconds.

Default value: 20

Integeryes

guiDescription

Here you can assign a string that is displayed next to the assigned gui number in the dropdown box of the Login dialog.

JSON objectno


The settings file could look like this:

Enter:

JS
{
  "host": "ws://myServer:8091/",
  "audioStreamURL": "http://myServer:8090/turbo/PrelistenFile/%@",
  "waveformURL":
  "http://myServer:8090/turbo/WaveFormFile/%@",
  "maxPrelistenCache": 20,
  "prelistenEndOffset": 20,
  "guiDescription": {
        "0": "zero",
        "1": "Desktop",
        "2": "Mobile",
        "3": "Tablet"
  } 
}

Confirm Validity

Modifying the file settings.json can easily introduce errors, because it must follow strict JSON specifications. Two mistakes are most common:

  1. Missing comma at the end of a line.
  2. Missing quotes for the parameter name (string to the left of the colon).

It is recommended to run any modifications to settings.json trough a JSON linter, which checks the code for validity. An easy to access and free solution can be found under: http://www.jsonlint.com/

Simply copy and paste the full contents of settings.json and click “Validate JSON”.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.