ggerganov/ggwave

Что это?

Ключевые возможности

• 01Передаёт небольшие объёмы данных с помощью слышимого или ультразвукового звука.
• 02Использует FSK-модуляцию с коррекцией ошибок Reed-Solomon.
• 03Работает с любым аудиобэкендом через колбэки для добавления и извлечения аудиосэмплов.
• 04Предоставляет биндинги для Python, Node.js и Swift.
• 05Включает примеры для ESP32, Arduino и Raspberry Pi Pico.

Сценарии использования

• Передача короткого сообщения или кода сопряжения между находящимися рядом устройствами без подключения к сети.
• Отправка команд с ПК или телефона на микроконтроллеры с микрофоном или динамиком.
• Создание функций офлайн-сопряжения устройств или обмена контактами.
• Разработка прототипов протоколов передачи данных по звуку для IoT-проектов.

Быстрый старт

1. 1

   Установите пакет Python

   pip install ggwave
2. 2

   Или соберите библиотеку C++ и CLI с помощью CMake

   git clone https://github.com/ggerganov/ggwave --recursive && cd ggwave && mkdir build && cd build && cmake .. && make
3. 3

   Запустите инструмент командной строки

   ./bin/ggwave-cli

Что важно знать

• !Пропускная способность очень низкая — примерно 8–16 байт в секунду.
• !Для сборки примеров на основе SDL необходимо отдельно установить SDL2.

Темы

Частые вопросы

Что такое ggwave?

Компактная библиотека на C++ для передачи небольших объёмов данных между устройствами с помощью звука; доступна для Python, JavaScript и микроконтроллеров. ggwave позволяет устройствам обмениваться небольшими объёмами данных с помощью звука — это полезно, когда у них нет возможности подключиться к сети. Библиотека использует многотоновую FSK-модуляцию с коррекцией ошибок Reed-Solomon и передаёт сигналы как в слышимом, так и в ультразвуковом диапазоне. Заявленная пропускная способность составляет примерно 8–16 байт в секунду и зависит от параметров протокола.

ggwave можно использовать бесплатно? Какая у него лицензия?

ggwave распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

ggwave всё ещё поддерживается?

Нет коммитов больше 6 месяцев. Последний коммит в ggwave — 16 апр. 2026 г..

Для чего можно использовать ggwave?

Передача короткого сообщения или кода сопряжения между находящимися рядом устройствами без подключения к сети. Отправка команд с ПК или телефона на микроконтроллеры с микрофоном или динамиком. Создание функций офлайн-сопряжения устройств или обмена контактами. Разработка прототипов протоколов передачи данных по звуку для IoT-проектов.

Как установить ggwave?

Установите пакет Python: pip install ggwave Или соберите библиотеку C++ и CLI с помощью CMake: git clone https://github.com/ggerganov/ggwave --recursive && cd ggwave && mkdir build && cd build && cmake .. && make Запустите инструмент командной строки: ./bin/ggwave-cli

Где скачать ggwave?

Исходный код и инструкции по установке — на GitHub: https://github.com/ggerganov/ggwave