README.md

July 31, 2026 ยท View on GitHub

Description

ovos-microphone-plugin-pyaudio is a microphone plugin for OpenVoiceOS (OVOS). It captures audio through PyAudio (PortAudio) and does not depend on speech_recognition. The plugin maps sample_width to the matching PyAudio format and supports int8, int16, int24, int32, and float32 capture.

Install

pip install ovos-microphone-plugin-pyaudio

The plugin needs the libportaudio2 system library on Linux, macOS, and Windows.

Usage

OVOS loads this plugin through the opm.microphone entry point. Select it in mycroft.conf:

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

See docs/index.md for the full configuration reference, the float32 output example for ggwave, and the device selection rules.

OVOS ships other microphone plugins in the same family:

License

Apache-2.0