README.md

July 31, 2026 · View on GitHub

Description

OVOS Microphone Files plugin.

This plugin implements the OVOS Plugin Manager Microphone interface. It reads audio from wave files instead of a real microphone. The plugin watches a folder for new files, reads each file as audio input, and deletes the file after it processes it.

Use this plugin to feed pre-recorded audio into an OVOS pipeline, for example in tests or automated demos.

Install

pip install ovos-microphone-plugin-files

Usage

The plugin watches ~/file_microphone by default. Drop a wave file into this folder, and the plugin reads it, splits it into chunks, and queues the chunks as microphone input. After it reads a file, the plugin deletes it, unless you set autodelete to False.

Configure the plugin under listener in mycroft.conf:

{
  "listener": {
    "microphone": {
      "module": "ovos-microphone-plugin-files"
    }
  }
}

License

Apache-2.0