ggerganov/ggwave

Health v2 · maintenance only

Adoption not part of the score

7840 stars · 466 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

ggwave is a tiny C++ library that transmits small amounts of data over sound using an FSK-based protocol with error correction, playable and capturable through any audio backend. It supports air-gapped device communication, IoT microcontrollers, audio QR codes, and device pairing, with bindings for Python, JavaScript, and embedded platforms.

Use cases

• send data between air-gapped devices using sound
• transmit data over audio to microcontrollers like arduino or esp32
• implement audio QR codes for broadcasting small payloads
• pair devices without network connectivity using sound
• share files between devices serverlessly via speakers and microphones
• decode data-over-sound signals in python or javascript

When to choose

• you need to move tiny payloads (8-16 bytes/sec) between devices with no network
• you want acoustic data transfer on embedded hardware or in the browser
• you need a serverless one-to-many broadcast channel via sound

When to avoid

• you need to transfer large files or high-bandwidth data
• you require reliable communication in noisy acoustic environments
• you need encrypted or authenticated channels out of the box

Facets

library · maturity active

audio-processing sdk serialization error-handling embedded-systems iot developer-tools cross-platform cross-platform python cpp embedded cli data-over-sound fsk ultrasound acoustic-data-transfer audio-qrcode device-pairing ecc modem arduino esp32 audio nodejs web

Member repositories

For agents

markdown · JSON · MCP: product_card(name="ggerganov/ggwave")