AI Norden connector for Windows
===============================

What this is: a tiny background agent that watches the folder where the
Norden Statistics addon writes your closed trades and uploads every new
or changed file to your AI Norden dashboard. It reads nothing else on
your machine and does no analysis locally; the coaching happens server
side.

It only uploads sessions traded from the day you install it onwards.
Whatever you traded before that stays on your computer.

ONE TIME SETUP, THEN FORGET IT

1. Sign in to your dashboard and click "Get pairing code". Copy the code.

2. Create a permanent folder for the program, for example C:\AINorden, and
   move ai-norden-connector.exe into it.
   IMPORTANT: pick a folder you will not delete or move later. Do not run
   it from your Downloads folder. The connector remembers its own location
   so it can start automatically with Windows, and moving or deleting it
   afterwards breaks that.

3. Double click ai-norden-connector.exe. Windows SmartScreen may warn
   because the file is new: click More info, then Run anyway.

4. A small window asks for your pairing code. Paste it and click OK.

5. You will see "All set". That is it.

ONE FIRST STEP IN BOOKMAP, IMPORTANT THE FIRST TIME

Install the Norden Statistics addon and tick it on every instrument you
trade. It is what writes the files this connector reads, so until it is
on, your dashboard stays empty. The download and the steps are on the
Setup page of your dashboard.

From then on the connector runs silently in the background and starts
automatically every time you turn on your PC. There is no window to keep
open and nothing else to do. Just trade in Bookmap and watch your
dashboard update while you trade.

THE SECOND PIECE: THE NORDEN STATISTICS ADDON

The connector sends files. Something has to write them, and that is our
addon, which runs inside Bookmap.

It writes your closed trades, and alongside them what the market was
doing around each of your orders: the book around your price, where you
stood in the queue, and the exact moment each order was placed, moved,
cancelled or filled. That is what makes time to fill and distance to the
spread real measurements instead of estimates.

It installs separately and takes a few minutes. The install steps and the
download are on the Setup page of your dashboard.

The connector picks up its files automatically once it is running. There
is nothing to configure here.

RUNNING IT, STOPPING IT, REMOVING IT

  Is it running? Open Task Manager and look for ai-norden-connector.exe,
  or run in Command Prompt:

      tasklist | findstr ai-norden-connector

  Stop it now:

      taskkill /IM ai-norden-connector.exe /F

  Start it again: double click the exe.

  Stop it starting when you sign in: open Task Manager, go to the Startup
  tab, and disable AINordenConnector. From Command Prompt the same thing
  is:

      reg delete "HKCU\Software\Microsoft\Windows\CurrentVersion\Run" /v AINordenConnector /f

  Remove it completely: stop it, disable the startup entry, then delete
  the exe along with ai-norden-connector.json and
  ai-norden-connector.log next to it. Nothing else is left behind.

SETTINGS

Edit ai-norden-connector.json next to the exe, then stop and start the
connector for the change to take effect. That file is the one that
counts.

  installed_on     Sessions traded before this day are never uploaded.
                   Stamped once, on the day you installed. Write it as
                   2026-08-01, four digit year, month and day. A day
                   written 2026-8-1 is read and corrected on the next
                   start; anything that is not a date falls back to today.
  upload_history   Set to true to also upload everything you traded
                   before installing. Off by default.
  poll_seconds     How often the folder is checked, in whole seconds and
                   without quotes. Lowering it does not make the dashboard
                   faster: Bookmap rewrites the export roughly once or
                   twice a minute, and that is the limit.
  folder           Force a specific export folder. Leave empty to detect
                   it automatically.

STAYING UP TO DATE

From this version on the connector keeps itself current. It checks for a
new release a few times a day and installs it when you are not in a
session, then starts the new one by itself. There is nothing to click
and no reinstall to do.

The version it replaces is kept right next to it as
ai-norden-connector.exe.old. If you are ever asked to go back, close the
connector from Task Manager, delete ai-norden-connector.exe, rename the
.old file back to ai-norden-connector.exe and start it again.

To stay on the version you have, add this to ai-norden-connector.json:

  "auto_update": false

GOOD TO KNOW

* No Bookmap yet? Run the connector anyway. It waits and begins the
  moment there is a closed trade to send.
* It finds the folder on its own, wherever your version keeps it.
* Your first closed trade is what starts it. Nothing appears before that.
* The addon records only the instruments you ticked it on. Tick it on
  every one you trade.
* If the connector cannot reach the server, a firewall, proxy or
  antivirus may be blocking it. It tells you instead of saying All set,
  and keeps retrying.
* A connection log is saved as ai-norden-connector.log next to the
  program.

If the dashboard stays empty, check that log and reach out.
