# 2 RACEMAP forwarder

<figure><img src="/files/sROjDRSQDCp8Ti3KUeak" alt="" width="563"><figcaption><p>The forwarder UI shows the connected timing software and some stats.</p></figcaption></figure>

**The Forwarder: Simple Now, Powerful Tomorrow**\
The Forwarder features an intuitive, easy-to-use interface designed for seamless operation. And we’re just getting started — future updates will bring expanded functionality and support. RACEMAP is actively working to integrate more systems to ensure full compatibility with all major local timing solutions.

Want to see your system included in the Forwarder? We’d love to hear from you — reach out and let’s connect!

<figure><img src="/files/iXkiWOilvuPSx7HWcpWJ" alt=""><figcaption><p>Flow of information schema</p></figcaption></figure>

You can download the software for Windows and Linux from [github.com](https://github.com/racemap/2-racemap-forwarder)

### How does the forwarder work?

* Opens a port, on your local machine: **3000** for ChronoTrack
* Opens a second port, on your local machine: **3097** for MyLaps
* Listens on localhost IP: **127.0.0.1**
* Waits for TCP/IP connections from ChronoTrack Simple Client software
* Processes passings/reads send by the ChronoTrack Simple Client software
* Waits for TCP/IP connections from MyLaps Timing software
* Processes passings/reads send by the MyLaps Timing software
* Uses RACEMAP's **API token** to forward data to RACEMAP

### How to get an API token?

{% content-ref url="/pages/1bq15cJtzdnjBPSV9Bx7" %}
[Authentication](/api/authentication.md)
{% endcontent-ref %}

### **How to use the forwarder?**

1. Get the timing API token for your RACEMAP account, contact <info@racemap.com>.
2. Download the forwarder to the computer on which the ChronoTrack timing software is running.&#x20;
3. Run the forwarder with the **RACEMAP\_API\_TOKEN** token as an environment variable.
4. Configure your ChronoTrack timing software to send data to the forwarder.
5. The forwarder will send your data to RACEMAP.&#x20;

<pre class="language-sh"><code class="lang-sh"><strong>set RACEMAP_API_TOKEN=[APItoken]
</strong>.\chronotrack-to-racemap-forwarder.exe
</code></pre>

### How to operate the forwarder?

#### Basic

Download the latest binary for windows or for linux and run it with below commands.

{% tabs %}
{% tab title="Windows" %}
Download the forwarder here: [2-to-racemap-forwarder-win-x64-v1.1.0.exe](https://github.com/racemap/2-racemap-forwarder/releases/download/v1.1.0/2-racemap-forwarder-win-x64-v1.2.0.exe)&#x20;

* Place it in a writable folder (your home folder)
* Start by double click
* Paste your API token into the corresponding input

<pre class="language-sh"><code class="lang-sh"><strong>set RACEMAP_API_TOKEN=[APItoken]
</strong>.\2-racemap-forwarder.exe
</code></pre>

<figure><img src="/files/HBUlk5Gbzyv2GDiCE9Ya" alt=""><figcaption></figcaption></figure>

* Start your MyLaps Timing or ChronoTrack Simple Client and configure a connection&#x20;
* For ***MyLaps Timing*** use Port `3097` as destination
* For ***ChronoTrack SimpleClient*** use Port `3000` as destination.
  {% endtab %}

{% tab title="Linux" %}
Download the forwarder here: [2-racemap-forwarder-linux-x64-v1.1.0](https://github.com/racemap/2-racemap-forwarder/releases/download/v1.1.0/2-racemap-forwarder-linux-x64-v1.1.0)

In a shell use the following commands to configure and start the forwarder.

```sh
export RACEMAP_API_TOKEN=[APItoken]
./2-racemap-forwarder 
```

Replace `[APItoken]` with the unique API token of your RACEMAP account.&#x20;
{% endtab %}
{% endtabs %}

**Expert**

Go to [github.com/2-racemap-forwarder](https://github.com/racemap/2-racemap-forwarder) and start developing.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.racemap.com/prediction/timekeeping/other-timingsystem/forwarder.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.