REPLAY

replay :- replay.

This replays urenlopen from previous editions. It implements a mockup ronny that sends out realistic data from previous editions.

A similar but different project named SIMSALABIM generates events to simulate specific or new situations.

This project supersedes mityri.

Requirements

Ronny dumps from a previous edition are required; these can be downloaded from https://dataset.12urenloop.be.

Setup

1. Put the ronny01.json, ronny02.json, ... in the dumps directory.
2. Setup with or without Docker (see next section)
3. Make sure the environment variables in the compose or .env file are correct.
   • API_URL: The URL that points to the this replay emulator, this is required for telraam to reach the 'fake' ronny's. REPLAY directly connects to the telraam database and changes the station URLs to API_URL as the base domain.
   • START_TIME: Unix timestamp of when the replay should start. The default is the start of the 12urenloop in 2024.
4. Create the database (according to the env) and initialize it with the telraam dump for the correct edition.
   • https://dataset.12urenloop.be should also include a telraam.sql backup. For restoring the database, see the telraam wiki

Setup With docker

There is a docker-compose.yml available that will run the replay application, a Postgres database, Telraam and Loxsi.

Setup Without docker

The dependencies are managed with uv. Install uv.

Install all the dependencies with:

uv sync

Activate the virtual environment with:

source .venv/bin/activate

Create an .env:

cp .env.sample .env

Usage

There are currently two API endpoints available:

• /{ronny0[1-9]}: The websocket endpoints where Telraam will connect to for each ronny. Path will be /ronny01 for ronny1, /ronny02 for ronny2,...
• /reset: Accepts a time datetime query parameter. REPLAY will change its internal clock to this datetime.
  • This will close al open ronny websockets from Telraam, and Telraam should then automatically retry and open new websockets for each ronny.
  • It also deletes the detection and lap records with a more recent timestamp from the telraam database.

See also /docs to get an interactive swagger dashboard.

DISCLAIMER: Starting up or resetting into a datetime far into the event can take some time as it needs to catch up and send out all the previous detections.

TODO: The 10urenloop dumps from 2024 somehow do not work.