Running StatConverter from sources

StatConverter can also be started directly from its source files, which is especially useful for development and testing on any supported platform.

The first step is to create a clone of the GitHub repository

Node.js needs to be installed; we recommend at least version 22, which is what the project currently uses.

Then open a Terminal in the clone of the StatConverter directory, and type:

npm install

After Node.js will install all the necessary modules, type:

npm start

to start the application.

Build your own binaries

On Windows, users need to install the Microsoft Visual Studio Tools (we've installed the 2019 community version, especially the C++ build tools) and also Git, which also needs to be on the system PATH.

MacOS users need to install the XCode Command Line Tools (either from the entire XCode, otherwise the CLTs are sufficient).

On all platforms, the recommended build command is:

npm run dist

This command builds the application in production mode and dispatches to the appropriate platform-specific packaging flow. On Linux, it uses a dedicated Linux-only build script and then runs the Linux artifact renaming script automatically, so there is no longer any need to edit or remove other platform build configuration by hand.

The generated binaries are written to the build/output directory.