ws-protocol icon indicating copy to clipboard operation
ws-protocol copied to clipboard

Foxglove Studio WebSocket protocol specification and libraries

Foxglove WebSocket Protocol

This repository provides a protocol specification and reference implementations enabling Foxglove to ingest arbitrary “live” streamed data.

A Foxglove WebSocket server can provide multiple data streams, called channels. When a client subscribes to a channel, it begins receiving messages on that channel. This protocol does not prescribe the messages' data format. Instead, the server specifies each channel's encoding, and the client uses this information to determine whether it can decode that channel's messages. Read the Foxglove documentation for more information on which encodings Foxglove supports.

Implementations are available in the following languages:

Language Includes Package name Version
Python server + examples foxglove-websocket
JavaScript/TypeScript server + client @foxglove/ws-protocol
JavaScript/TypeScript examples @foxglove/ws-protocol-examples
C++ server + examples foxglove-websocket

Additional resources

  • https://foxglove.github.io/ws-protocol - Connect to a ws-protocol compliant server and measure data throughput
  • eCAL Foxglove Bridge – WebSocket bridge that allows users to connect eCAL systems to Foxglove for easy visualization and debugging