Skip to content

Plugin email notifications ssl

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

E-mail Notifications SSL

Sends OSPy event and login notifications through SMTP over SSL with an optional retry queue.

At a glance

Item Value
Version 1.1.6
Category Notifications and remote communication
Author Martin Pihrt
License GPL-3.0
OSPy 3.0.211 or newer
Python 3.8 or newer
Permissions email, files, network
Hardware No dedicated hardware requirement declared
Dependencies None
Python/OS packages blinker (required)
Interfaces Mobile API v1
Source Open the plug-in directory

What it is for

Sends OSPy event and login notifications through SMTP over SSL with an optional retry queue.

How it works and how to configure it

Version 1.1.3 skips optional data sections when their provider plug-in is disabled or stopped, without aborting the remaining e-mail. Version 1.1.2 keeps one empty line between independent sections in HTML messages. Before adding the optional virtual water-meter section, the plug-in briefly waits for the completed master counter to be stored so the message does not show a transient zero value.

Only for Python 3+

This plugin can send E-mails. For this plugin you need an E-mail SMTP account as provider. This extension is a more modern variant of the original E-mail notifications extension (Connection via SSL layer)

The plug-in includes an OSPy plugin.json manifest, registers its notification and retry worker with the shared plug-in runtime, manages system signal receivers through the common lifecycle, and implements health(). Diagnostics reports worker, signal receiver and SMTP configuration state, queued message count, latest successful SSL delivery, and recent errors without exposing credentials or recipients.

Version 1.1.0 extends the existing optional Water Consumption Counter data in finished-run e-mails. When Send data from virtual water meter is enabled and the running counter provides data, the message includes the applicable master, its estimated consumption during its current or just-finished activation, its total counter and the completed station consumption. The two run values can differ due to master delays or consecutive stations. Values from 1000 liters are displayed in cubic meters. If the counter is absent or has no data for that station, the rest of the e-mail is sent normally without this section.

Plugin setup

  • Check Send E-mail after power on for send E-mail: If checked sends E-mail into your E-mail address.

  • Check with log file: If checked with events.log file if exists (your must enabled in options "check Enable debug log").

  • Check Send E-mail if rain sensor is activated: If checked send E-mail into your E-mail address.

  • Check Send E-mail if rain sensor is deactivated: If checked send E-mail into your E-mail address.

  • Check Send E-mail if a program has finished: If checked send E-mail if a program has finished into your E-mail address.

  • Send data from virtual water meter: Adds completed-run and total master consumption when Water Consumption Counter is installed, running and has data for the station.

  • Check Send E-mail if the rain delay has setuped: If checked send E-mail if the rain delay has setuped.

  • Check Send E-mail if the rain delay has expired: If checked send E-mail if the rain delay has expired.

  • Check Send E-mail if the user is logged in: If checked send E-mail if the user is logged in to system.

  • SMTP server address: Example: smtp.seznam.cz

  • SMTP port: Example: 465 (number in range 0-65535)

  • Use SMTP username as sender: Some SMTP providers prohibit to use another sender than the same mail user.

  • SMTP username: Type your E-mail password.

  • SMTP password: Type your E-mail password.

  • Send E-mail to: Type more E-mail address for recipient E-mail post office.

  • E-mail subject: Type E-mail subject for send E-mail.

  • Save and send it later: If there is no Internet connection, save and send it later.

  • Status: Status window from the plugin.

This extension also sends some statuses from other extensions (if they are installed on the system). For example temperature, flow...

Example recieve E-mail

Systém 2021-07-10 18:11:33 Ukončené zalévání Program: Jednorázový Stanice: Ventilátor sklep Čas startu: 2021-07-10 18:11:29 Trvání: 00:04 Voda Množství vody v zásobníku: Úroveň: 192 cm (72 %), Ping: 211 cm, Objem: 1448.25 litrů Čítač spotřeby vody Měřeno od dne: 2021-04-01 10:18:10, Hlavní stanice: 56.97 m3, Druhá hlavní stanice: 0.0 Litr Teplota DS1-DS6 SKLEP: 20.0 C BAZÉN: 21.0 C BOJLER: 59.3 C UVNITŘ: 21.6 C STUDNA: 15.0 C VENKU: 31.0 C Snímače S1: 21.3 C S2: Kontakt spojený S3: 68 cm (100 %)

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 extension is for Python 3 only.

This extension is a more modern variant of the original E-mail notifications extension (Connection via SSL layer).

This plugin can send E-mails. For this plugin you need an E-mail SMTP account as provider.

Plugin setup

  • Check Send E-mail after power on for send E-mail

If checked sends E-mail into your E-mail address.

  • Check with log file

If checked with events.log file if exists (your must enabled in options "check Enable debug log").

  • Check Send E-mail if rain sensor is activated

If checked send E-mail into your E-mail address.

  • Check Send E-mail if rain sensor is deactivated

  • Check Send E-mail if a program has finished

If checked send E-mail if a program has finished into your E-mail address.

  • Send data from virtual water meter

If enabled and Water Consumption Counter has data for the completed station, the e-mail includes master run consumption, total master consumption and station consumption.

  • Check Send E-mail if the rain delay has setuped

If checked send E-mail if the rain delay has setuped into your E-mail address.

  • Check Send E-mail if the rain delay has expired

If checked send E-mail if the rain delay has expired into your E-mail address.

  • Check Send E-mail if the user is logged in

If checked send E-mail if the user is logged in to system into your E-mail address.

  • SMTP server address

Example: smtp.seznam.cz

  • SMTP port

Example: 465 (number in range 0-65535)

  • Use SMTP username as sender

Some SMTP providers prohibit to use another sender than the same mail user.

  • SMTP username

Type your E-mail password

  • SMTP password

  • Send E-mail to

Type more E-mail address for recipient E-mail post office.

  • E-mail subject

Type E-mail subject for send E-mail.

  • Save and send it later

If there is no Internet connection, save and send it later.

  • Status

Status window from the plugin.

This extension also sends some statuses from other extensions (if they are installed on the system). For example temperature, flow...

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