GitHub - ggerganov/ggwave: Tiny data-over-sound library

ggwave is an open-source framework for transmitting data via audio signals, enabling communication between devices like smartphones, computers, and microcontrollers without needing Wi-Fi or internet. It splits data into packets with Reed-Solomon error correction to ensure reliability, then encodes them using frequency-shift keying (FSK) modulated onto an audio stream. This allows messages to be played over speakers and received by a microphone on another device within close proximity.

Key features include:

• Cross-platform compatibility: Supports Linux/macOS/Windows, iOS/Android mobile apps, embedded systems like Arduino/Raspberry Pi Pico, and web-based interfaces via Web Audio API.

• Diverse use cases: Examples include file sharing with sound signaling (Wave Share), IoT device communication, and educational tools for exploring modulation protocols (Wave-GUI). Libraries exist for Python, Node.js, and Swift Package Manager.

• Resilience: Error correction ensures robustness against environmental noise during transmission.

The project provides pre-built binaries and installation guides across ecosystems:

• Linux/macOS/Windows via CMake/MSYS2.

• WebAssembly for browser use with Emscripten.

• Python/NPM packages for integration into scripts or apps.

• Snap package (Linux) and Homebrew support (macOS).

GGwave’s modular design allows customization of protocols, making it adaptable to various hardware constraints and application needs. It demonstrates the potential of acoustic data transmission for proximity-based communication in constrained environments.