2.12.0

OWLCMS Tracker Release Notes

⚠ To use Tracker, you need to use version 64 or newer of OWLCMS (see Installing Locally below)

Release log

• 2.12.0: fixes to support packaging of combined plugins with shared content

• 2.9.0: Clean-up of large unnecessary dependencies that were specific to some plugins -- puppeteer is no longer included by default

• 2.9.0: Plugins and extensions can specify additional dependencies that are not part of the base build

• 2.9.0: Additional dependencies listed in the plugins and extensions are included in zip distributions

• 2.8.3: extensions now inherit the default values of the base scoreboard

• 2.8.3: refactored the team-scoreboard extension mechanism

• 2.8.2: Share attempt bar presentation and backend for unified translations on all scoreboards

• 2.8.2: Thin border on scoreboard flags for when there is black on the flags

• 2.8.1: Fixed flags for teams scoreboard and standard scoreboards

• 2.8.0: Support for extensions to the team scoreboard for additional scoring formulas

• 2.7: Improved contrast and additional visual cues for bad lifts on scoreboards

• 2.7: Scoreboard translations come from owlcms (no fallbacks)

• 2.7: Plugins reorganized in subfolders to facilitate connecting submodules with additional plugins (e.g. IWF Books)

  • Plugins are still shown on entry page based on the category in config.js

Installing Locally

• Install the latest version 3.0 of the OWLCMS control-panel

  • There will be a Tracker tab where you can click to install Tracker

  • This installs the normal plugins to support people watching remotely

    • To access experimental or additional example plugins, see Installing from Source.

  • Also install the latest version 64 of OWLCMS (you may need to select it as a prerelease)

OWLCMS Configuration

Before using this tracker, you must configure OWLCMS to send data via WebSocket:

• If you installed from the control panel, there is an option on the OWLCMS page to send the data to tracker, in the Options dropdown. Use the "Enable" option -- after enabling, the dropdown will show "Disable", which means it's enabled...

• Alternatively, you can configure in your database

  • In OWLCMS: Prepare Competition → Language and System Settings → Connections → URL for Video Data

  • Set to: ws://localhost:8096/ws (or wss://your-tracker-host:8096/ws for secure connections)

Other Installation Methods

Docker Installation

Alternatively, run the tracker in Docker:

docker run -d \
  --name owlcms-tracker \
  -p 8096:8096 \
  docker.io/owlcms/tracker:latest

Then access the tracker at: http://localhost:8096

Note: Use latest for the newest release. You can also use a specific release number such as 2.0.0-beta01 if needed.

Installing from Source

To run the tracker from source code (for development or to access experimental plugins):

1. Clone the repository:

   git clone https://github.com/owlcms/owlcms-tracker.git
   cd owlcms-tracker

2. Install dependencies:

   npm install

   Note: This project uses @owlcms/tracker-core. If you need to install it manually:

   npm install github:owlcms/tracker-core

3. Run the tracker:

   npm run dev

The tracker will be available at: http://localhost:8096

Support

For issues and questions, visit: https://github.com/jflamy/owlcms-tracker/issues

2.11.0

OWLCMS Tracker Release Notes

⚠ To use Tracker, you need to use version 64 or newer of OWLCMS (see Installing Locally below)

Release log

• 2.9.0: Clean-up of large unnecessary dependencies that were specific to some plugins -- puppeteer is no longer included by default

• 2.9.0: Plugins and extensions can specify additional dependencies that are not part of the base build

• 2.9.0: Additional dependencies listed in the plugins and extensions are included in zip distributions

• 2.8.3: extensions now inherit the default values of the base scoreboard

• 2.8.3: refactored the team-scoreboard extension mechanism

• 2.8.2: Share attempt bar presentation and backend for unified translations on all scoreboards

• 2.8.2: Thin border on scoreboard flags for when there is black on the flags

• 2.8.1: Fixed flags for teams scoreboard and standard scoreboards

• 2.8.0: Support for extensions to the team scoreboard for additional scoring formulas

• 2.7: Improved contrast and additional visual cues for bad lifts on scoreboards

• 2.7: Scoreboard translations come from owlcms (no fallbacks)

• 2.7: Plugins reorganized in subfolders to facilitate connecting submodules with additional plugins (e.g. IWF Books)

  • Plugins are still shown on entry page based on the category in config.js

Installing Locally

• Install the latest version 3.0 of the OWLCMS control-panel

  • There will be a Tracker tab where you can click to install Tracker

  • This installs the normal plugins to support people watching remotely

    • To access experimental or additional example plugins, see Installing from Source.

  • Also install the latest version 64 of OWLCMS (you may need to select it as a prerelease)

OWLCMS Configuration

Before using this tracker, you must configure OWLCMS to send data via WebSocket:

• If you installed from the control panel, there is an option on the OWLCMS page to send the data to tracker, in the Options dropdown. Use the "Enable" option -- after enabling, the dropdown will show "Disable", which means it's enabled...

• Alternatively, you can configure in your database

  • In OWLCMS: Prepare Competition → Language and System Settings → Connections → URL for Video Data

  • Set to: ws://localhost:8096/ws (or wss://your-tracker-host:8096/ws for secure connections)

Other Installation Methods

Docker Installation

Alternatively, run the tracker in Docker:

docker run -d \
  --name owlcms-tracker \
  -p 8096:8096 \
  docker.io/owlcms/tracker:latest

Then access the tracker at: http://localhost:8096

Note: Use latest for the newest release. You can also use a specific release number such as 2.0.0-beta01 if needed.

Installing from Source

To run the tracker from source code (for development or to access experimental plugins):

1. Clone the repository:

   git clone https://github.com/owlcms/owlcms-tracker.git
   cd owlcms-tracker

2. Install dependencies:

   npm install

   Note: This project uses @owlcms/tracker-core. If you need to install it manually:

   npm install github:owlcms/tracker-core

3. Run the tracker:

   npm run dev

The tracker will be available at: http://localhost:8096

Support

For issues and questions, visit: https://github.com/jflamy/owlcms-tracker/issues

2.10.0

OWLCMS Tracker Release Notes

⚠ To use Tracker, you need to use version 64 or newer of OWLCMS (see Installing Locally below)

Release log

• 2.10.0: team-scoreboard and extensions thereof can produce Excel output of the results

• 2.9.0: Clean-up of large unnecessary dependencies that were specific to some plugins -- puppeteer is no longer included by default

• 2.9.0: Plugins and extensions can specify additional dependencies that are not part of the base build

• 2.9.0: Additional dependencies listed in the plugins and extensions are included in zip distributions

• 2.8.3: extensions now inherit the default values of the base scoreboard

• 2.8.3: refactored the team-scoreboard extension mechanism

• 2.8.2: Share attempt bar presentation and backend for unified translations on all scoreboards

• 2.8.2: Thin border on scoreboard flags for when there is black on the flags

• 2.8.1: Fixed flags for teams scoreboard and standard scoreboards

• 2.8.0: Support for extensions to the team scoreboard for additional scoring formulas

• 2.7: Improved contrast and additional visual cues for bad lifts on scoreboards

• 2.7: Scoreboard translations come from owlcms (no fallbacks)

• 2.7: Plugins reorganized in subfolders to facilitate connecting submodules with additional plugins (e.g. IWF Books)

  • Plugins are still shown on entry page based on the category in config.js

Installing Locally

• Install the latest version 3.0 of the OWLCMS control-panel

  • There will be a Tracker tab where you can click to install Tracker

  • This installs the normal plugins to support people watching remotely

    • To access experimental or additional example plugins, see Installing from Source.

  • Also install the latest version 64 of OWLCMS (you may need to select it as a prerelease)

OWLCMS Configuration

Before using this tracker, you must configure OWLCMS to send data via WebSocket:

• If you installed from the control panel, there is an option on the OWLCMS page to send the data to tracker, in the Options dropdown. Use the "Enable" option -- after enabling, the dropdown will show "Disable", which means it's enabled...

• Alternatively, you can configure in your database

  • In OWLCMS: Prepare Competition → Language and System Settings → Connections → URL for Video Data

  • Set to: ws://localhost:8096/ws (or wss://your-tracker-host:8096/ws for secure connections)

Other Installation Methods

Docker Installation

Alternatively, run the tracker in Docker:

docker run -d \
  --name owlcms-tracker \
  -p 8096:8096 \
  docker.io/owlcms/tracker:latest

Then access the tracker at: http://localhost:8096

Note: Use latest for the newest release. You can also use a specific release number such as 2.0.0-beta01 if needed.

Installing from Source

To run the tracker from source code (for development or to access experimental plugins):

1. Clone the repository:

   git clone https://github.com/owlcms/owlcms-tracker.git
   cd owlcms-tracker

2. Install dependencies:

   npm install

   Note: This project uses @owlcms/tracker-core. If you need to install it manually:

   npm install github:owlcms/tracker-core

3. Run the tracker:

   npm run dev

The tracker will be available at: http://localhost:8096

Support

For issues and questions, visit: https://github.com/jflamy/owlcms-tracker/issues

2.9.0

OWLCMS Tracker Release Notes

⚠ To use Tracker, you need to use version 64 or newer of OWLCMS (see Installing Locally below)

Release log

• 2.9.0: Clean-up of large unnecessary dependencies that were specific to some plugins -- puppeteer is no longer included by default

• 2.9.0: Plugins and extensions can specify additional dependencies that are not part of the base build

• 2.9.0: Additional dependencies listed in the plugins and extensions are included in zip distributions

• 2.8.3: extensions now inherit the default values of the base scoreboard

• 2.8.3: refactored the team-scoreboard extension mechanism

• 2.8.2: Share attempt bar presentation and backend for unified translations on all scoreboards

• 2.8.2: Thin border on scoreboard flags for when there is black on the flags

• 2.8.1: Fixed flags for teams scoreboard and standard scoreboards

• 2.8.0: Support for extensions to the team scoreboard for additional scoring formulas

• 2.7: Improved contrast and additional visual cues for bad lifts on scoreboards

• 2.7: Scoreboard translations come from owlcms (no fallbacks)

• 2.7: Plugins reorganized in subfolders to facilitate connecting submodules with additional plugins (e.g. IWF Books)

  • Plugins are still shown on entry page based on the category in config.js

Installing Locally

• Install the latest version 3.0 of the OWLCMS control-panel

  • There will be a Tracker tab where you can click to install Tracker

  • This installs the normal plugins to support people watching remotely

    • To access experimental or additional example plugins, see Installing from Source.

  • Also install the latest version 64 of OWLCMS (you may need to select it as a prerelease)

OWLCMS Configuration

Before using this tracker, you must configure OWLCMS to send data via WebSocket:

• If you installed from the control panel, there is an option on the OWLCMS page to send the data to tracker, in the Options dropdown. Use the "Enable" option -- after enabling, the dropdown will show "Disable", which means it's enabled...

• Alternatively, you can configure in your database

  • In OWLCMS: Prepare Competition → Language and System Settings → Connections → URL for Video Data

  • Set to: ws://localhost:8096/ws (or wss://your-tracker-host:8096/ws for secure connections)

Other Installation Methods

Docker Installation

Alternatively, run the tracker in Docker:

docker run -d \
  --name owlcms-tracker \
  -p 8096:8096 \
  docker.io/owlcms/tracker:latest

Then access the tracker at: http://localhost:8096

Note: Use latest for the newest release. You can also use a specific release number such as 2.0.0-beta01 if needed.

Installing from Source

To run the tracker from source code (for development or to access experimental plugins):

1. Clone the repository:

   git clone https://github.com/owlcms/owlcms-tracker.git
   cd owlcms-tracker

2. Install dependencies:

   npm install

   Note: This project uses @owlcms/tracker-core. If you need to install it manually:

   npm install github:owlcms/tracker-core

3. Run the tracker:

   npm run dev

The tracker will be available at: http://localhost:8096

Support

For issues and questions, visit: https://github.com/jflamy/owlcms-tracker/issues

2.8.3

OWLCMS Tracker Release Notes

⚠ To use Tracker, you need to use version 64 of OWLCMS (see Installing Locally below)

Release log

• 2.8.3: extensions now inherit the default values of the base scoreboard

• 2.8.3: refactored the team-scoreboard extension mechanism

• 2.8.2: Share attempt bar presentation and backend for unified translations on all scoreboards

• 2.8.2: Thin border on scoreboard flags for when there is black on the flags

• 2.8.1: Fixed flags for teams scoreboard and standard scoreboards

• 2.8.0: Support for extensions to the team scoreboard for additional scoring formulas

• 2.7: Improved contrast and additional visual cues for bad lifts on scoreboards

• 2.7: Scoreboard translations come from owlcms (no fallbacks)

• 2.7: Plugins reorganized in subfolders to facilitate connecting submodules with additional plugins (e.g. IWF Books)

  • Plugins are still shown on entry page based on the category in config.js

Installing Locally

• Install the latest version 3.0 of the OWLCMS control-panel

  • There will be a Tracker tab where you can click to install Tracker

  • This installs the normal plugins to support people watching remotely

    • To access experimental or additional example plugins, see Installing from Source.

  • Also install the latest version 64 of OWLCMS (you may need to select it as a prerelease)

OWLCMS Configuration

Before using this tracker, you must configure OWLCMS to send data via WebSocket:

• If you installed from the control panel, there is an option on the OWLCMS page to send the data to tracker, in the Options dropdown. Use the "Enable" option -- after enabling, the dropdown will show "Disable", which means it's enabled...

• Alternatively, you can configure in your database

  • In OWLCMS: Prepare Competition → Language and System Settings → Connections → URL for Video Data

  • Set to: ws://localhost:8096/ws (or wss://your-tracker-host:8096/ws for secure connections)

Other Installation Methods

Docker Installation

Alternatively, run the tracker in Docker:

docker run -d \
  --name owlcms-tracker \
  -p 8096:8096 \
  docker.io/owlcms/tracker:latest

Then access the tracker at: http://localhost:8096

Note: Use latest for the newest release. You can also use a specific release number such as 2.0.0-beta01 if needed.

Installing from Source

To run the tracker from source code (for development or to access experimental plugins):

1. Clone the repository:

   git clone https://github.com/owlcms/owlcms-tracker.git
   cd owlcms-tracker

2. Install dependencies:

   npm install

   Note: This project uses @owlcms/tracker-core. If you need to install it manually:

   npm install github:owlcms/tracker-core

3. Run the tracker:

   npm run dev

The tracker will be available at: http://localhost:8096

Support

For issues and questions, visit: https://github.com/jflamy/owlcms-tracker/issues

2.8.2

OWLCMS Tracker Release Notes

⚠ To use Tracker, you need to use version 64 of OWLCMS (see Installing Locally below)

Release log

• 2.8.2: Share attempt bar presentation and backend for unified translations on all scoreboards

• 2.8.2: Thin border on scoreboard flags for when there is black on the flags

• 2.8.1: Fixed flags for teams scoreboard and standard scoreboards

• 2.8.0: Support for extensions to the team scoreboard for additional scoring formulas

• 2.7: Improved contrast and additional visual cues for bad lifts on scoreboards

• 2.7: Scoreboard translations come from owlcms (no fallbacks)

• 2.7: Plugins reorganized in subfolders to facilitate connecting submodules with additional plugins (e.g. IWF Books)

  • Plugins are still shown on entry page based on the category in config.js

Installing Locally

• Install the latest version 3.0 of the OWLCMS control-panel

  • There will be a Tracker tab where you can click to install Tracker

  • This installs the normal plugins to support people watching remotely

    • To access experimental or additional example plugins, see Installing from Source.

  • Also install the latest version 64 of OWLCMS (you may need to select it as a prerelease)

OWLCMS Configuration

Before using this tracker, you must configure OWLCMS to send data via WebSocket:

• If you installed from the control panel, there is an option on the OWLCMS page to send the data to tracker, in the Options dropdown. Use the "Enable" option -- after enabling, the dropdown will show "Disable", which means it's enabled...

• Alternatively, you can configure in your database

  • In OWLCMS: Prepare Competition → Language and System Settings → Connections → URL for Video Data

  • Set to: ws://localhost:8096/ws (or wss://your-tracker-host:8096/ws for secure connections)

Other Installation Methods

Docker Installation

Alternatively, run the tracker in Docker:

docker run -d \
  --name owlcms-tracker \
  -p 8096:8096 \
  docker.io/owlcms/tracker:latest

Then access the tracker at: http://localhost:8096

Note: Use latest for the newest release. You can also use a specific release number such as 2.0.0-beta01 if needed.

Installing from Source

To run the tracker from source code (for development or to access experimental plugins):

1. Clone the repository:

   git clone https://github.com/owlcms/owlcms-tracker.git
   cd owlcms-tracker

2. Install dependencies:

   npm install

   Note: This project uses @owlcms/tracker-core. If you need to install it manually:

   npm install github:owlcms/tracker-core

3. Run the tracker:

   npm run dev

The tracker will be available at: http://localhost:8096

Support

For issues and questions, visit: https://github.com/jflamy/owlcms-tracker/issues

2.8.1

OWLCMS Tracker Release Notes

⚠ To use Tracker, you need to use version 64 of OWLCMS (see Installing Locally below)

Release log

• 2.8.1: Fixed flags for teams scoreboard and standard scoreboards

• 2.8.0: Support for extensions to the team scoreboard for additional scoring formulas

• 2.7: Improved contrast and additional visual cues for bad lifts on scoreboards

• 2.7: Scoreboard translations come from owlcms (no fallbacks)

• 2.7: Plugins reorganized in subfolders to facilitate connecting submodules with additional plugins (e.g. IWF Books)

  • Plugins are still shown on entry page based on the category in config.js

Installing Locally

• Install the latest version 3.0 of the OWLCMS control-panel

  • There will be a Tracker tab where you can click to install Tracker

  • This installs the normal plugins to support people watching remotely

    • To access experimental or additional example plugins, see Installing from Source.

  • Also install the latest version 64 of OWLCMS (you may need to select it as a prerelease)

OWLCMS Configuration

Before using this tracker, you must configure OWLCMS to send data via WebSocket:

• If you installed from the control panel, there is an option on the OWLCMS page to send the data to tracker, in the Options dropdown. Use the "Enable" option -- after enabling, the dropdown will show "Disable", which means it's enabled...

• Alternatively, you can configure in your database

  • In OWLCMS: Prepare Competition → Language and System Settings → Connections → URL for Video Data

  • Set to: ws://localhost:8096/ws (or wss://your-tracker-host:8096/ws for secure connections)

Other Installation Methods

Docker Installation

Alternatively, run the tracker in Docker:

docker run -d \
  --name owlcms-tracker \
  -p 8096:8096 \
  docker.io/owlcms/tracker:latest

Then access the tracker at: http://localhost:8096

Note: Use latest for the newest release. You can also use a specific release number such as 2.0.0-beta01 if needed.

Installing from Source

To run the tracker from source code (for development or to access experimental plugins):

1. Clone the repository:

   git clone https://github.com/owlcms/owlcms-tracker.git
   cd owlcms-tracker

2. Install dependencies:

   npm install

   Note: This project uses @owlcms/tracker-core. If you need to install it manually:

   npm install github:owlcms/tracker-core

3. Run the tracker:

   npm run dev

The tracker will be available at: http://localhost:8096

Support

For issues and questions, visit: https://github.com/jflamy/owlcms-tracker/issues

2.8.0

OWLCMS Tracker Release Notes

⚠ To use Tracker, you need to use version 64 of OWLCMS (see Installing Locally below)

New in Release 2.8

• Various bug fixes
• Support for extensions to the team scoreboard for additional scoring formulas

New in Release 2.7

• Improved contrast and additional visual cues for bad lifts on scoreboards
• Scoreboard translations come from owlcms (no fallbacks)
• Plugins reorganized in subfolders to facilitate connecting submodules with additional plugins (e.g. IWF Books)
  • Plugins are still shown on entry page based on the category in config.js

Installing Locally

• Install the latest version 3.0 of the OWLCMS control-panel

  • There will be a Tracker tab where you can click to install Tracker

  • This installs the normal plugins to support people watching remotely

    • To access experimental or additional example plugins, see Installing from Source.

  • Also install the latest version 64 of OWLCMS (you may need to select it as a prerelease)

OWLCMS Configuration

Before using this tracker, you must configure OWLCMS to send data via WebSocket:

• If you installed from the control panel, there is an option on the OWLCMS page to send the data to tracker, in the Options dropdown. Use the "Enable" option -- after enabling, the dropdown will show "Disable", which means it's enabled...

• Alternatively, you can configure in your database

  • In OWLCMS: Prepare Competition → Language and System Settings → Connections → URL for Video Data

  • Set to: ws://localhost:8096/ws (or wss://your-tracker-host:8096/ws for secure connections)

Other Installation Methods

Docker Installation

Alternatively, run the tracker in Docker:

docker run -d \
  --name owlcms-tracker \
  -p 8096:8096 \
  docker.io/owlcms/tracker:latest

Then access the tracker at: http://localhost:8096

Note: Use latest for the newest release. You can also use a specific release number such as 2.0.0-beta01 if needed.

Installing from Source

To run the tracker from source code (for development or to access experimental plugins):

1. Clone the repository:

   git clone https://github.com/owlcms/owlcms-tracker.git
   cd owlcms-tracker

2. Install dependencies:

   npm install

   Note: This project uses @owlcms/tracker-core. If you need to install it manually:

   npm install github:owlcms/tracker-core

3. Run the tracker:

   npm run dev

The tracker will be available at: http://localhost:8096

Support

For issues and questions, visit: https://github.com/jflamy/owlcms-tracker/issues

2.7.1

OWLCMS Tracker Release Notes

⚠ To use Tracker, you need to use version 64 of OWLCMS (see Installing Locally below)

New in Release 2.7

• Improved contrast and additional visual cues for bad lifts on scoreboards
• Transparent background on shared clock/decision component
• Scoreboard translations come from owlcms (no fallbacks)
• Plugins reorganized in subfolders to facilitate connecting submodules with additional plugins (e.g. IWF Books)
  • Plugins still shown on entry page based on the category in config.js
• Missing translation keys from owlcms will show as !key (same as owlcms)

New in Release 2.6

• 2.6.2: Scoreboards and attempt boards now track the break and ceremony status same as OWLCMS
• Now uses a shared component for all attempt bars in all scoreboards
• When runnning locally, should be launched from control panel version 3.0 or later (see below)
• Node.js not included in packaging

New in Release 2.5

• 2.5.5: Display protocol version mismatch between owlcms and tracker-core
• 2.5.3: Network usage for the remote scoreboars radically reduced, general performance
  • removed unneeded fields
  • activated gzip compression
  • removed callbacks to API when data was sent by SSE and not language sensitive
  • fixed caching key to remove unneeded calls to tracker-core hub
• When installed from source, demo applications for printing documents

Installing Locally

• Install the latest version 3.0 of the (OWLCMS control-panel)[https://github.com/owlcms/owlcms-controlpanel/releases]

  • There will be a Tracker tab where you can click to install Tracker

  • This installs the normal plugins to support people watching remotely

    • To access experimental or additional example plugins, see Installing from Source.

  • Also install the latest version 64 of OWLCMS (you may need to select it as a prerelease)

OWLCMS Configuration

Before using this tracker, you must configure OWLCMS to send data via WebSocket:

• If you installed from the control panel, there is an option on the OWLCMS page to send the data to tracker, in the Options dropdown

• Alternatively, you can configure in your database

  • In OWLCMS: Prepare Competition → Language and System Settings → Connections → URL for Video Data

  • Set to: ws://localhost:8096/ws (or wss://your-tracker-host:8096/ws for secure connections)

Docker Installation

Alternatively, run the tracker in Docker:

docker run -d \
  --name owlcms-tracker \
  -p 8096:8096 \
  docker.io/owlcms/tracker:latest

Then access the tracker at: http://localhost:8096

Note: Use latest for the newest release. You can also use a specific release number such as 2.0.0-beta01 if needed.

Installing from Source

To run the tracker from source code (for development or to access experimental plugins):

1. Clone the repository:

   git clone https://github.com/owlcms/owlcms-tracker.git
   cd owlcms-tracker

2. Install dependencies:

   npm install

   Note: This project uses @owlcms/tracker-core. If you need to install it manually:

   npm install github:owlcms/tracker-core

3. Run the tracker:

   npm run dev

The tracker will be available at: http://localhost:8096

Support

For issues and questions, visit: https://github.com/jflamy/owlcms-tracker/issues

2.7.0

OWLCMS Tracker Release Notes

⚠ To use Tracker, you need to use version 64 of OWLCMS (see Installing Locally below)

New in Release 2.7

• Plugins reorganized in subfolders to facilitate connecting submodules with additional plugins (e.g. IWF Books)
  • Plugins still shown on entry page based on the category in config.js
• Missing translation keys from owlcms will show as !key (same as owlcms)

New in Release 2.6

• 2.6.2: Scoreboards and attempt boards now track the break and ceremony status same as OWLCMS
• Now uses a shared component for all attempt bars in all scoreboards
• When runnning locally, should be launched from control panel version 3.0 or later (see below)
• Node.js not included in packaging

New in Release 2.5

• 2.5.5: Display protocol version mismatch between owlcms and tracker-core
• 2.5.3: Network usage for the remote scoreboars radically reduced, general performance
  • removed unneeded fields
  • activated gzip compression
  • removed callbacks to API when data was sent by SSE and not language sensitive
  • fixed caching key to remove unneeded calls to tracker-core hub
• When installed from source, demo applications for printing documents

Installing Locally

• Install the latest version 3.0 of the (OWLCMS control-panel)[https://github.com/owlcms/owlcms-controlpanel/releases]

  • There will be a Tracker tab where you can click to install Tracker

  • This installs the normal plugins to support people watching remotely

    • To access experimental or additional example plugins, see Installing from Source.

  • Also install the latest version 64 of OWLCMS (you may need to select it as a prerelease)

OWLCMS Configuration

Before using this tracker, you must configure OWLCMS to send data via WebSocket:

• If you installed from the control panel, there is an option on the OWLCMS page to send the data to tracker, in the Options dropdown

• Alternatively, you can configure in your database

  • In OWLCMS: Prepare Competition → Language and System Settings → Connections → URL for Video Data

  • Set to: ws://localhost:8096/ws (or wss://your-tracker-host:8096/ws for secure connections)

Docker Installation

Alternatively, run the tracker in Docker:

docker run -d \
  --name owlcms-tracker \
  -p 8096:8096 \
  docker.io/owlcms/tracker:latest

Then access the tracker at: http://localhost:8096

Note: Use latest for the newest release. You can also use a specific release number such as 2.0.0-beta01 if needed.

Installing from Source

To run the tracker from source code (for development or to access experimental plugins):

1. Clone the repository:

   git clone https://github.com/owlcms/owlcms-tracker.git
   cd owlcms-tracker

2. Install dependencies:

   npm install

   Note: This project uses @owlcms/tracker-core. If you need to install it manually:

   npm install github:owlcms/tracker-core

3. Run the tracker:

   npm run dev

The tracker will be available at: http://localhost:8096

Support

For issues and questions, visit: https://github.com/jflamy/owlcms-tracker/issues