OVOS Simple Listener
ovos-simple-listener is a lightweight alternative to ovos-dinkum-listener, designed for efficient wake word detection and speech recognition.
This listener provides a streamlined approach for integrating voice command capabilities into your applications using the Open Voice OS (OVOS) framework.
It was made to power hivemind-listener and hivemind-mic-satellite, but can also be used in place of ovos-dinkum-listener in your OVOS setups
at around 150 Lines of code, this repo is a good clean reference of how to use OVOS audio plugins in your own applications
Features
- Wake Word Detection: Supports customizable wake word engines to initiate listening.
- Voice Activity Detection (VAD): Detects silence and speech to optimize audio processing.
- Speech Recognition: Utilizes various speech-to-text (STT) engines to transcribe audio input.
- Callback System: Provides a flexible callback mechanism to handle state changes and processed audio.
- Multithreading Support: Operates in a separate thread to avoid blocking the main application flow.
While this repo is lighter than ovos-dinkum-listener, it is also missing some features
- Audio Transformers plugins
- Continuous Listening
- Hybrid Listening
- Recording Mode
- Sleep Mode
- Multiple WakeWords
Installation
To use ovos-simple-listener, clone this repository and install the necessary dependencies. You can do this using pip:
pip install ovos-simple-listener
OVOS Usage
run ovos_simple_listener/__main__.py in place of ovos-dinkum-listener, plugins are selected from the default OVOS config ~/.config/mycroft/mycroft.conf
Library Usage
To use ovos-simple-listener, you can initialize it with the desired components (microphone, STT, VAD, and wake word) as shown in the example below:
from ovos_simple_listener import SimpleListener
from ovos_plugin_manager.microphone import OVOSMicrophoneFactory
from ovos_plugin_manager.stt import OVOSSTTFactory
from ovos_plugin_manager.vad import OVOSVADFactory
from ovos_plugin_manager.wakewords import OVOSWakeWordFactory
listener = SimpleListener(
mic=OVOSMicrophoneFactory.create(),
vad=OVOSVADFactory.create(),
wakeword=OVOSWakeWordFactory.create_hotword("hey_mycroft"),
stt=OVOSSTTFactory.create()
)
listener.run()
Callbacks
You can implement your own callbacks by extending the ListenerCallbacks class to handle events such as starting a command, ending listening, processing audio, errors, and recognizing text.
from ovos_simple_listener import ListenerCallbacks
class MyCallbacks(ListenerCallbacks):
@classmethod
def listen_callback(cls):
# Handle when the listener starts processing a command
pass
@classmethod
def end_listen_callback(cls):
# Handle when the listener stops processing a command
pass
@classmethod
def audio_callback(cls, audio):
# Handle processed audio data
pass
@classmethod
def error_callback(cls, audio):
# Handle STT errors
pass
@classmethod
def text_callback(cls, utterance, lang):
# Handle recognized text
pass
Contributing
Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.
Acknowledgements
- Open Voice OS for providing the framework and plugins.
Metadata
Release files for ovos-simple-listener 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ovos_simple_listener-0.1.0.tar.gz | 10.1 kB | Without provenance | Details for ovos_simple_listener-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ovos_simple_listener-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for ovos_simple_listener-0.1.0-py3-none-any.whl |
Total release size: 20.6 kB
Release files / ovos_simple_listener-0.1.0.tar.gz
| Download URL | ovos_simple_listener-0.1.0.tar.gz |
|---|---|
| Size | 10.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
460ddb77452dcb1de7b6873ddad0a143cad3c7df1b2af11b52fc28e11d3c3c38
|
|
BLAKE2b-256 checksum How to use checksums |
32333f642ee3c81d0b86a25dd5692d0cbc0dc8ed3c23dc42c4a0f517bae122a6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Release files / ovos_simple_listener-0.1.0-py3-none-any.whl
| Download URL | ovos_simple_listener-0.1.0-py3-none-any.whl |
|---|---|
| Size | 10.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
422630cca20dcac0b2c21e8cc19a38be1c144e0f12366da3a73b4d7d5746a525
|
|
BLAKE2b-256 checksum How to use checksums |
092f79c6ce592b8ca399ea11735d93c6c25f35724d169f156cea9df0af8ad326
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Security for ovos-simple-listener 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.