Skip to content

Plugin voice station

Martin Pihrt edited this page Oct 13, 2026 · 1 revision

Voice Station

Queues and plays audio when station outputs change, regardless of what triggered the station.

At a glance

Item Value
Version 1.0.0
Category Notifications and remote communication
Author Martin Pihrt
License GPL-3.0
OSPy 3.0.211 or newer
Python 3.8 or newer
Permissions files, subprocess
Hardware Declared in the manifest
Dependencies None
Python/OS packages None
Interfaces No provider or mobile API declared
Source Open the plug-in directory

What it is for

Queues and plays audio when station outputs change, regardless of what triggered the station.

How it works and how to configure it

Tested in Python 3+

This plugin allows you to use voice notifications for stations events in the OSPy system. Into the Connector from Output on Raspberry Pi connect Amplifier and Speakers for voice notification. If more than one station is activated in a row, the songs are added to the queue and then played from the queue. You can upload any song with any name in mp3 and wav format to the song directory. Unlike the "voice notification" package, this extension has no connection to the station scheduler (ie how the programs and the stations assigned in them are set up). In this extension, the song will be played whenever the station status changes, regardless of what event the status triggered (for example, manual mode, scheduler, or some other plugin...)

The plug-in includes a manifest for compatibility checks, uses the shared OSPy worker lifecycle, stops active audio commands during shutdown, and reports its state through the Diagnostics health interface. WAV playback needs aplay and amixer; MP3 files additionally need ffmpeg.

Plugin setup

  • Enable voice: If the check box is marked, the extension will be active.

  • Master volume: Setting the Raspberry Pi output volume (0 - 100%).

  • Play only from: Play notifications only from this time (0 - 23 hour).

  • Play only to: Play notifications only to this time (0 - 23 hour).

  • Status: Status window from the plugin.

  • Upload sound file: file must be in mp3 or wav format!

Visit Martin Pihrt's blog. for more information.

In-app help and settings notes

The following notes are generated from the help page shipped with this plug-in. Field names are also explained directly in the OSPy settings page.

This plugin allows you to use voice notifications for stations events in the OSPy system.

Unlike the voice notification extension, this extension works directly with the output (ie changing the station on or off).

Into the Connector from Output on Raspberry Pi connect Amplifier and Speakers for voice notification.

If more than one station is activated in a row, the songs are added to the queue and then played from the queue.

You can upload any song with any name in mp3 and wav format to the song directory.

Unlike the "voice notification" package, this extension has no connection to the station scheduler (ie how the programs and the stations assigned in them are set up). In this extension, the song will be played whenever the station status changes, regardless of what event the status triggered (for example, manual mode, scheduler, or some other plugin...)

Support

Check OSPy → Diagnostics first and remove passwords, tokens, private addresses and other secrets before sharing logs. Report reproducible plug-in problems in the OSPy-plugins issue tracker.

Back to the plug-in catalog

Clone this wiki locally