Skip to content

Plugin voice notification

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

Voice Notification

Plays scheduled voice announcements before configured OSPy program and station events.

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

Plays scheduled voice announcements before configured OSPy program and station events.

How it works and how to configure it

Tested in Python 3+

This plugin allows you to use voice notifications for different events in the OSPy system. Into the Connector from Output on Raspberry Pi connect Amplifier and Speakers for voice notification. This plugin requires pygame installed. Install python3-pygame from the system package manager when it is not already available. The plugin will always play sound and next then the sound assigned to the station (for example: voice3.mp3). Unlike the "voice station" package, this extension has a connection to the program scheduler (ie how the programs and stations assigned in them are set up.) In this extension, the song is played some time before the program starts.

The plug-in includes a manifest for compatibility and dependency checks, uses the shared OSPy worker lifecycle, and reports its state through the Diagnostics health interface.

Plugin setup

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

  • Pre run time: How many seconds before turning on stations play sound (1 - 59 sec).

  • Repeat playback: How many times to repeat the same message (1 - 3x).

  • 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).

  • Skip stations: Skip voice notification for these stations (multiple select).

  • Select voice for stations: Select voice for this station (voice0.mp3-voice20.mp3)

  • 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 different events in the OSPy system.

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

This plugin requires pygame installed. If pygame is not installed on the system, plugin it will install it himself. Pygame is comes already installed on the default raspberian installation.

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

Unlike the "voice station" package, this extension has a connection to the program scheduler (ie how the programs and stations assigned in them are set up.) In this extension, the song is played some time before the program starts...

Visit and for more information

Related links and diagrams

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