diff --git a/platypush/plugins/sound/__init__.py b/platypush/plugins/sound/__init__.py index 70d410297..88f432e09 100644 --- a/platypush/plugins/sound/__init__.py +++ b/platypush/plugins/sound/__init__.py @@ -13,6 +13,18 @@ class SoundPlugin(RunnablePlugin): """ Plugin to interact with a sound device. + Among the other features, enabling this plugin allows you to stream audio + over HTTP from the device where the application is running, if + :class:`platypush.backend.http.HttpBackend` is enabled. + + Simply open + ``http://:/sound/stream.[mp3|wav|acc|ogg]?token=`` + to access live recording from the audio device. + + It can also be used as a general-purpose audio player and synthesizer, + supporting both local and remote audio resources, as well as a MIDI-like + interface through the :meth:`.play` command. + Triggers: * :class:`platypush.message.event.sound.SoundPlaybackStartedEvent` on playback start @@ -29,6 +41,8 @@ class SoundPlugin(RunnablePlugin): * **sounddevice** (``pip install sounddevice``) * **numpy** (``pip install numpy``) * **ffmpeg** package installed on the system + * **portaudio** package installed on the system - either + ``portaudio19-dev`` on Debian-like systems, or ``portaudio`` on Arch. """ diff --git a/platypush/plugins/sound/manifest.yaml b/platypush/plugins/sound/manifest.yaml index c44f0f17b..d8166fe04 100644 --- a/platypush/plugins/sound/manifest.yaml +++ b/platypush/plugins/sound/manifest.yaml @@ -14,7 +14,9 @@ manifest: - numpy apt: - ffmpeg + - portaudio19-dev pacman: - ffmpeg + - portaudio package: platypush.plugins.sound type: plugin