Livescore

The Livescore feature provides the ability to publish the scores of the current match via an HTML snippet. This enables you to include realtime scores in your live streams (e.g. via OBS).

Note that this feature is available in the Pro version only.

Usage

To use Livescore you first need to enable it in your app settings as you can see in the first screenshot. From the start page go to More -> Settings -> Livescore and click the switch right to Active.

As you can see from the screenshot the address for receiving live update is directly shown in the app. You can copy this address and paste it in a browser or OBS for example.

https://billiard-score.com/livescore? host=192.168.1.2 &port=8014

The values for host and port can differ for your device.

Now, go back to the start page and open a new or existing match as shown in the second screenshot above. As soon as a match is shown on the device it will start to send updates to the HTML snippet as shown in the screenshot below.

Note: The app uses network port 8014 by default. If you have problems with the connection try to use a different port number. It is possible that the port is used by another app already.

Extra information

Apart from the discipline, player names and scores there are fields for additional static information that can be displayed. These are extra0, extra1 and extra2. These fields can be used for example to add the name of your club or similar information.

Use the following URL and adjust the fields to your needs:

https://billiard-score.com/livescore? host=192.168.1.2 &port=8014 &extra0=My%20club &extra1=Billiard%20Score &extra2=My%20league

Technical background

How does livescore work? The feature consists basically of two components - a web server and a HTML/JS snippet. The app itself starts a small websocket server on the device that listenes for connections at the specified port. The HTML/JS snippet connects to the websocket with the provided connection information (IP address and port). Now whenever there is a change (e.g. match points changed) the websocket will push this information to the connected snippet.