This is a web application for announcing orienteerers passing at a relay control. Data is read from MeOS.
The sound files are from the similar prewarning project.
Node.js version >= 22.6.0 is required.
You can obtain it by using nvm (Node Version Manager). Download it from
NVM
After installing nvm, you can install and use the required Node.js version
like this:
nvm install 22.6.0
nvm use 22.6.0Alternatively you can download and install it globally from Node.js.
- Install Node.js
- Run
npm installin the project directory
Add a settings.json file in the root, to configure the application.
There is an settings.example.json file to start with.
All available settings can be seen in the schema.ts file.
Allow audio to be automatically played in the client web browser.
- Go to
chrome://settings/content/siteDetails?site=http://localhost:3001 - Change the
Soundsetting toAllow
- Go to browser settings
- Search for
autoplay - Click
Settings...forAutoplay - Add an exception for
http://localhost:3001toAllow Audio and Video
You might have to replace localhost with the IP address of the host
computer, if you are accessing the application from another device.
- Start MeOS and open the competition you want to announce
- Start the MeOS "Informationsserver" under the "Automater" tab.
- Run
npm startin the project directory - Open a web browser and go to
http://localhost:3001
It should also be possible to access the application from a browser on another
device on the same network. Replace localhost with the IP address of the
host computer.
You can use the MeOS backup in test/relay.meosxml. Load it in MeOS to get a
simple competition with a few controls and teams. In MeOS you can manually
enter passing times under the "Speaker" tab.
Data fetched from MeOS is logged to the logs folder. This folder might grow
with time, so it might be a good idea to delete old logs.