Omi Device Go SDK (omidevice)

Protocol helpers + optional BLE scan/listen for the Omi wearable.

Default build (no hardware)

go test ./...

Exports UUIDs, StripPacketHeader, STT helpers. Scan / Listen / ListenPayload / ReadCodec return ErrBLEDisabled.

BLE build (-tags ble)

Uses tinygo.org/x/bluetooth (CoreBluetooth on macOS, BlueZ on Linux). Compiles on desktop darwin/arm64.

go test -tags ble ./...
go run -tags ble ./examples/...   # if present

devices, err := omidevice.Scan(ctx, 5*time.Second)
err = omidevice.ListenPayload(ctx, devices[0].ID, func(payload []byte) {
    // Opus/PCM frames with 3-byte header stripped
})

Mirrors Python print_devices / listen_to_omi in sdks/python/omi/bluetooth.py.

Limitations

• Needs Bluetooth permission/adapter; CI and headless hosts stay on default build.
• macOS device IDs are CoreBluetooth identifiers (not always classic MACs).
• ReadCodec relies on GATT Read; may fail if characteristic is notify-only on some firmware.