Release pub.dev

Flutter Snowboy plugin

This is alpha quality software. Caveat emptor!

This repository contains the source code to the Flutter Snowboy package. Snowboy is a cross-platform DNN-based hotword detection toolkit.

The plugin currently only supports the Android and iOS platforms.

Models

The Flutter Snowboy package requires a working Snowboy detection model (pmdl) to be useful. To train your own model, clone this repo and follow the instructions.

How to use

Add dependency to project

Add this to the dependencies list in your pubspec.yaml file:

  flutter_snowboy: ">=0.1.1"

Initialize detector

import 'package:flutter_snowboy/flutter_snowboy.dart';

...

// Instantiate
var detector = Snowboy();

// Load model and other resources.
// This is a moderately expensive operation since it involves file I/O.
var success = detector.prepare("/absolute/path/to/model.pmdl");

Start

void hwHandler() {
    print("Hotword detected");
}

detector.hotwordHandler = hwHandler;

// ... get audio data as UInt8List and feed into detection function.
// Audio data should be 16 kHz, 16-bit mono PCM

detector.detect(data);

// ... and hwHandler() gets called when the hotword is detected.

Contributing

All contributions are welcome. If you would like to lend and hand, feel free to fork this repository and open pull requests.

Version History

0.1.1 - Null safety + minor fixes. Now requires Dart 2.12+ (12-01-2022)
0.1.0 - Initial release (24-08-2022)

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

https://www.apache.org/licenses/LICENSE-2.0 or here

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.