Multi-room audio over
Wi-Fi HaLow.

LongWave Audio is an open-source system for synchronized audio across a home, shed, yard, or wider property. It combines Snapcast, librespot, ESP32-S3 endpoints, and sub-GHz Wi-Fi HaLow networking all running locally with no cloud dependency.

LongWave endpoint board beside a small blue enclosure with antenna
Endpoint hardware and enclosure

Getting Started

Set up the server

Run Snapserver, librespot, and optional AirPlay services with Docker.

Read the server guide

Flash firmware

Install prebuilt endpoint firmware from Chrome or Edge over USB-C.

Open the web flasher

How it works

Audio starts on a Linux host, moves through Snapcast in a Docker container, crosses the HaLow network, and ends at an ESP32-S3 endpoint that turns the stream into analogue audio.

Linux host
Docker container
librespot Spotify Connect
Snapserver sync + routing
TCP/IP LAN
Access point

HaLow-capable AP

Bridge between the wired or 2.4 GHz LAN and the sub-GHz HaLow network.

OTA Wi-Fi HaLow
Endpoint
HaLow board
ESP32-S3
Audio DAC
Analogue audio
Output

Speakers

Audio out to powered speakers, an amplifier, or line-level input.

Credits

LongWave Audio is built on top of the excelent work of many open-source audio projects. This repository simply ties them together with Wi-Fi HaLow hardware, firmware builds, and setup documentation.

Snapcast

Snapcast by Johannes Pohl is the synchronized multi-room audio engine. Snapserver routes, timestamps, and distributes audio streams to clients.

librespot

librespot is the open-source Spotify Connect implementation used on the server side to receive Spotify audio and feed it into Snapserver.

snapclient for ESP32

snapclient for ESP32 by CarlosDerSeher brings Snapcast playback to embedded ESP32 hardware. LongWave uses a HaLow adapted fork for the endpoint firmware.