EuroScope Data Bridge

01 · About

What is Data Bridge?

EuroScope Data Bridge is a plugin DLL that runs inside EuroScope. Once loaded it automatically starts a WebSocket server on the local 127.0.0.1:48521. External programs (web pages, scripts, data-analysis tools) can subscribe to events such as runway activity changes, radar position updates and flight plan changes, or actively query and modify EuroScope data. All communication uses JSON text — a simple protocol with no third-party runtime dependencies.

02 · Architecture

Architecture

The plugin runs as a DLL inside the EuroScope process: it collects data through EuroScope SDK callbacks and pushes it to external clients through the built-in WebSocket server.

• Push mode (subscription-based) — EuroScope callback events are automatically serialized to JSON. A client must first subscribe to the event types it is interested in; only subscribed clients receive the matching events. When no client has subscribed to an event type, its callback is skipped entirely (no serialization, no push).
• Pull / Request mode — clients send JSON requests (e.g. get_flightplans, get_full_snapshot); each request runs on its own async worker thread and the result is returned over WebSocket as soon as it is ready.
• Heartbeat (optional) — clients may send ping and the server replies pong immediately; not enforced, combines with the timer event for liveness detection.
• Timed events — a timer event (with a tick counter) fires once per second, likewise only pushed to clients that subscribed to it — handy for polling or heartbeat detection.

03 · Features

Key features

04 · Tech stack

Tech stack

05 · Quick start

Quick start

const ws = new WebSocket('ws://127.0.0.1:48521');

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  console.log(msg.type, msg.data);
};

ws.onopen = () => {
  // Subscribe to events: pushes are only delivered for subscribed types
  ws.send(JSON.stringify({
    type: 'subscribe', id: 'sub-1',
    data: { events: ['radar_update', 'flightplan_update', 'timer'] }
  }));

  // Query all flight plans
  ws.send(JSON.stringify({ type: 'get_flightplans', id: 'req-1' }));
};

06 · Docs

Full documentation

07 · Download

Download