Ultrasound image preview

This application displays PNG frames supplied by your local probe driver. Connecting the viewer does not start acquisition. It labels recorded replays separately from live images.

Connect your local driver

  1. Keep your native probe preview server running. Note its loopback address.
  2. In an OpenDeviceDB checkout, start the read-only bridge. Replace DRIVER_PORT and the page origin with your actual values:
npm run ultrasound:bridge -- --upstream http://127.0.0.1:DRIVER_PORT --allow-origin https://opendevicedb.org
  1. Open the preview, keep http://127.0.0.1:4337 as the bridge URL, and choose Connect preview. Allow local network access if your browser requests it.
  2. Start or manage acquisition in the native driver. Choose Disconnect preview to stop reading images in this page.

For local development use the exact page origin, such as http://127.0.0.1:4335, with --allow-origin. The bridge only accepts that origin and only forwards status and cached image requests. Unsupported driver responses are rejected.

What the image means

The preview is uncalibrated. It supplies no distance measurement or diagnostic interpretation. A replay without a known probe profile is labelled “Probe not identified”; displaying it does not validate compatibility with the connected probe. Real-time availability depends on the driver producing new complete frames. A finished acquisition can continue to show its last image.

Back to components and applications