Skip to content

Latest commit

 

History

History
61 lines (45 loc) · 1.97 KB

README.md

File metadata and controls

61 lines (45 loc) · 1.97 KB
Raw

snips-volume

About

This script is an addon for https://snips.ai

Snips currently doesn't allow you to change the audio volume of the TTS engine.

This script tries to solve that by listening on the MQTT topics hermes/sound/setvolume and hermes/sound/getvolume.
Volume is changed through Alsa.

If a get request is detected, the script will reply on hermes/sound/volume with the current volume.
Usage in an environment with multiple satellites is supported through the siteId.

Dependencies

  • paho - python MQTT
  • toml - library to read the snips configuration file
  • alsaaudio- library to talk to the alsa audio services

Installation

copy snips-volume.py to /opt/snips-volume/
copy snips-volume.service to /etc/systemd/system/

sudo chmod +x /opt/snips-volume/snips-volume.py
sudo systemctl enable snips-volume.service
sudo systemctl start snips-volume.service

Message Format

In Messages

hermes/sound/setvolume

JSON Payload:

Key Value
siteId Site where the volume should be changed
volume The new volume level

hermes/sound/getvolume

JSON Payload:

Key Value
siteId Site where you want to request the current volume level

Out Messages

hermes/sound/volume

JSON Payload:

Key Value
siteId Site for the volume information
volume The current volume level

Troubleshooting

  • If alsaaudio fails to install, libasound2-dev might have to be installed through apt-get
  • When the script doesn't seem to work, stop the service and run in with
    sudo python3 /opt/snips-volume/snips-volume.py from the terminal.
    If the script fails, you will see the errors this way.