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
- Keep your native probe preview server running. Note its loopback address.
- In an OpenDeviceDB checkout, start the read-only bridge. Replace
DRIVER_PORTand the page origin with your actual values:
npm run ultrasound:bridge -- --upstream http://127.0.0.1:DRIVER_PORT --allow-origin https://opendevicedb.org- Open the preview, keep
http://127.0.0.1:4337as the bridge URL, and choose Connect preview. Allow local network access if your browser requests it. - 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.

