// readme

sendspin-cpp

Standalone C++ library implementing the Sendspin synchronized audio streaming protocol. Builds on both ESP-IDF (ESP32) and host platforms (macOS/Linux). Designed to be consumed by ESPHome but has no ESPHome dependencies.

Features

  • Modular Sendspin role composition: artwork, color, controller, metadata, player, source, and visualizer
  • WebSocket client and server support
  • Mandatory Noise KKpsk2 encryption on every connection, with Pairing PSK token and pairing code pairing
  • Decodes FLAC and PCM and streams captured audio as FLAC or PCM, plus Opus decode and encode when built with SENDSPIN_ENABLE_OPUS (the default)
  • Cross-platform: ESP-IDF (ESP32) and host (macOS/Linux)

Documentation

  • Integration Guide β€” How to integrate sendspin-cpp into your application, including required callbacks, role composition, and platform setup
  • Internals β€” Internal architecture, threading model, and inter-class communication
  • **[Playback…