svar-wave

Веб-сервис на Go: принимает аудиофайлы по HTTP и воспроизводит их на сервере. HTTP — fiber v3, звук — beep v2. Поддерживаемые форматы: WAV, MP3, FLAC, OGG (Vorbis).

• загрузка файлов по HTTP (multipart), опционально с немедленным воспроизведением
• управление плеером: play / pause / stop, живой статус с позицией
• конфигурация через YAML
• режим демона (двойной fork, pidfile, лог в файл)
• graceful shutdown по SIGTERM/SIGINT
• встроенная тестовая HTML-страница (go:embed, бинарь полностью самодостаточен)

Требуется Go 1.25+.

make build        # нативная сборка -> bin/svar-wave
make release      # кросс-сборка под linux-amd64 + linux-arm64 + linux-arm7

Аудио-вывод (beep/oto) на Linux требует cgo и ALSA, поэтому:

Для ARM-целей make сам скачает deb-пакеты ALSA нужной архитектуры с deb.debian.org и развернёт их в .sysroots/ (можно стереть: make distclean). Имена кросс-компиляторов определяются автоматически; переопределить:

make arm7 CC_ARMV7=arm-linux-gnueabihf-gcc-14

Готовые бинари динамически линкуются с libasound.so.2, которая есть на любом обычном Linux (Raspberry Pi OS, Debian, Ubuntu и т.д.).

make run          # foreground
./bin/svar-wave -config config.yaml
./bin/svar-wave   # без -config ищет config.yaml (см. ниже)

Поиск конфига: если в -config передано имя без пути (или флаг опущен), файл ищется сначала в /etc/svar-wave/<имя>, затем в текущем каталоге. Явный путь (абсолютный или относительный с каталогом) используется как есть.

Флаги:

Демон:

./bin/svar-wave -config config.yaml -daemon   # старт
./bin/svar-wave -config config.yaml -stop     # остановка
tail -f svar-wave.log                         # логи

systemd: см. scripts/svar-wave.service (запускает сервис в foreground, рестартами управляет systemd).

config.yaml (все ключи имеют разумные значения по умолчанию):

http:
  host: "0.0.0.0"
  port: 8080
  body_limit_mb: 100      # максимальный размер загрузки

storage:
  dir: "./uploads"        # каталог для загруженных файлов

player:
  sample_rate: 44100      # всё приводится к этой частоте
  buffer_ms: 200
  resample_quality: 3     # качество ресемплера beep (1..4)

daemon:
  pid_file: "/tmp/svar-wave.pid"
  log_file: "./svar-wave.log"  # пусто = логи демона отбрасываются
  umask: 027

upload:
  autoplay: true          # играть сразу после загрузки

log:
  level: "info"           # debug | info | warn | error

Примеры:

# загрузить и сразу играть
curl -F "file=@song.mp3" localhost:8080/upload

# загрузить без автовоспроизведения
curl -F "file=@song.mp3" "localhost:8080/upload?autoplay=false"

# просто воспроизвести, не сохраняя на диск
curl -F "file=@song.mp3" "localhost:8080/upload?save=0"

curl -X POST localhost:8080/play/song.mp3
curl -X POST localhost:8080/pause
curl -X POST localhost:8080/stop
curl -s localhost:8080/status
# {"playing":true,"paused":false,"file":"song.mp3","position_ms":1200,"total_ms":214000}

Ответы — JSON; ошибки — {"message": "..."} с соответствующим HTTP-кодом. Имена файлов очищаются от путей и опасных символов (path traversal исключён).

На http://localhost:8080/ доступна тестовая страница: загрузка файла с прогресс-баром и переключателями «играть сразу» / «сохранять», список файлов с кнопками воспроизведения, pause/stop и статус плеера, обновляемый раз в секунду.

make vet fmt fmt-check test

Структура:

cmd/svarwave/main.go        # входная точка, флаги, демон, сигналы
internal/config/config.go   # YAML-конфиг + дефолты
internal/player/player.go   # beep-плеер: декодеры, ресемплинг, состояние
internal/server/server.go   # маршруты fiber v3
internal/server/web/        # встроенная тестовая страница
scripts/svar-wave.service   # systemd unit
Makefile                    # сборка: нативная + linux-amd64/arm64/arm7

• Одновременно воспроизводится один файл; новая загрузка/play прерывает текущий трек.
• Звук выводится на локальное устройство сервера (ALSA/PulseAudio); на машине без аудио speaker.Init вернёт ошибку, upload будет работать, а play вернёт 500.
• MP3/FLAC/OGG декодируются потоково; WAV — целиком в память.

MIT — см. LICENSE.