Plugin Catalog

Plug-in catalog

This catalog contains all 64 official OSPy plug-ins. Select a name for its purpose, operation, requirements, settings and troubleshooting information.

Irrigation and water management

Plug-in	Version	What it does
Current Loop Tanks Monitor	1.1.1	Monitors up to four water tanks through an ADS1115 and 4-20 mA pressure sensors.
Irrigation Safety	1.0.0	Monitors irrigation flow, pressure and tank level, learns station flow ranges and can stop outputs and disable the scheduler when a confirmed fault occurs.
Monthly Water Level	1.0.1	Applies a configurable irrigation percentage adjustment for each calendar month.
Pool Heating	1.0.0	Controls a pool circulation pump from pool and solar collector temperatures.
Pressure Monitor	1.1.1	Checks binary pipe pressure while the master station runs and can stop irrigation when pressure is missing.
Pressurizer	1.0.0	Pre-runs the master pump to build pressure before selected irrigation stations start.
Water Consumption Counter	1.2.7	Estimates and reports water consumption from configured station flow rates and master-station runtime.
Water Meter	1.2.1	Measures pulse-output water meters through a PCF8583 counter with live flow, history, CSV and optional SQL logging.
Water Tank Monitor	1.1.1	Measures ultrasonic tank level and volume, blocks irrigation on low water and exposes tank provider actions.
Weather-based Rain Delay	1.0.0	Sets OSPy rain delay from measured or Netatmo rainfall and configured weather thresholds.
Weather-based Water Level	1.1.2	Calculates hourly OSPy water-level adjustment from weather balance, Zimmerman or evapotranspiration methods.
Weather-based Water Level Netatmo	1.0.0	Adjusts OSPy water level using rainfall history from a configured Netatmo rain module.

Weather, climate and environmental sensors

Plug-in	Version	What it does
Air Temperature and Humidity Monitor	1.0.7	Monitors DHT temperature and humidity and optional DS18B20 sensors through an external I2C board.
Astro Sunrise and Sunset	1.0.6	Calculates astronomical dawn, sunrise, noon, sunset and dusk times for OSPy programs and mobile clients.
CHMI	1.0.7	Downloads CHMI or SHMU radar data, detects local rain and optionally controls a hardware map.
Temperature Switch	1.0.0	Starts and stops OSPy programs from configured temperature sources and hysteresis limits.
Thermostat	1.1.1	Controls up to 20 OSPy programs from independent temperature sources, hysteresis limits and operating windows.
Weather Dashboard	1.0.2	Displays selected OSPy sensor and plug-in values as configurable gauges or text.
Weather Stations	1.0.0	Displays selected OSPy sensor and plug-in values as configurable gauges or text.
Wind Speed Monitor	1.2.3	Measures wind through PCF8583 or Modbus sensors and can log, notify or run safety actions.

Energy and building control

Plug-in	Version	What it does
Door Opening	1.0.0	Activates a selected OSPy station for a bounded door or gate opening interval.
Energy Meter	1.0.7	Monitors Shelly three-phase electricity meters and stores import, export, tariff, cost and solar calculations.
Photovoltaic Boiler	1.0.0	Controls boiler heating between photovoltaic surplus and the public grid using configured temperature sources.
Shelly Cloud Integration	1.0.8	Loads and caches configured Shelly device states from the Shelly Cloud API for OSPy and other plug-ins.
Venetian Blind	1.2.8	Controls configured Shelly or compatible blinds, including tilt positions, automation rules and mobile actions.

Automation and integrations

Plug-in	Version	What it does
Automation Rules	1.1.4	Builds graphical AND/OR rules over cached provider and OSPy values, sends detailed notifications and optionally performs guarded control actions with incident locking.
Home Assistant	1.0.1	Publishes OSPy devices, controls and sensor values through Home Assistant MQTT Discovery.
MQTT	1.0.1	Shared MQTT client, status publishing and remote OSPy control.
Remote FTP Control	1.0.0	Exchanges command and status files through FTP for legacy remote control of OSPy.
RS485 Communication	1.0.3	Provides a central RS485 worker and FIFO rs485_queue for OSPy plug-ins, with Waveshare CH343G auto-detection, status monitoring and adapter testing.

Notifications and remote communication

Plug-in	Version	What it does
E-mail Notifications	1.0.1	Sends OSPy event notifications through a STARTTLS SMTP server with an optional retry queue.
E-mail Notifications SSL	1.1.6	Sends OSPy event and login notifications through SMTP over SSL with an optional retry queue.
E-mail Reader	1.0.0	Reads authenticated IMAP commands and controls OSPy programs, stations and system functions.
Remote Notifications	1.0.0	Sends OSPy status and event notifications to a configured remote PHP and SQL web service.
SMS Modem	1.0.0	Receives authorized SMS commands through a Gammu-compatible modem and returns OSPy status by SMS.
Telegram Bot	1.0.1	Sends Telegram notifications and accepts a limited set of OSPy control commands from subscribed chats.
Voice Notification	1.0.0	Plays scheduled voice announcements before configured OSPy program and station events.
Voice Station	1.0.0	Queues and plays audio when station outputs change, regardless of what triggered the station.

Hardware, displays and outputs

Plug-in	Version	What it does
Button Control	1.0.0	Controls OSPy functions through eight MCP23017 I2C buttons and indicator LEDs.
CLI Control	1.0.0	Runs administrator-configured shell commands when OSPy station states change.
Direct 16 Relay Outputs	1.0.0	Controls up to 16 direct Raspberry Pi GPIO relay outputs with configurable trigger polarity.
IP Cam	1.0.0	Downloads, caches and proxies JPEG, GIF and MJPEG images from IP cameras.
LCD Display	1.0.2	Displays OSPy status information on a 16x2 HD44780 LCD through a PCF8574 I2C expander.
Modbus Stations	1.0.0	Controls OSPy station outputs through Modbus RTU serial relay boards.
Pulse Output Test	1.0.0	Pulses a selected OSPy station at 1 Hz for a bounded valve-location test.
Real Time and NTP time	1.0.1	Synchronizes system time with NTP and supported I2C real-time clocks.
Relay Test	1.0.0	Runs a bounded test of the OSPy relay output.
UPS Monitor	1.0.5	Monitors mains power and can notify, shut down OSPy and switch off a UPS after a sustained outage.
Voltage and Temperature Monitor	1.0.0	Measures and logs voltages or LM35 temperatures through a PCF8591 I2C converter.
Webcam Monitor	1.0.0	Captures and serves snapshots from a Linux USB webcam using fswebcam.

Network, data and system maintenance

Plug-in	Version	What it does
Database Connector	1.1.3	Provides shared MySQL access, backup and durable queued writes for OSPy plug-ins.
IP Scanner	1.0.0	Scans the local network for devices, names, MAC addresses and common web services.
Network Ping Monitor	1.0.2	Monitors three network targets through ICMP and optionally logs availability and latency.
OSPy package Backup	1.0.5	Creates downloadable ZIP archives of installed plug-in data directories.
Ping Monitor	1.0.0	Monitors host reachability, logs outages and can notify or restart a device after repeated failures.
Speed Monitor	1.0.0	Measures and logs Internet ping, download and upload performance at scheduled intervals.
System Debug Information	1.0.1	Displays, downloads and clears the OSPy technical debug log.
System Information	1.0.1	Displays operating-system, hardware, network, process, storage, USB, serial and optional I2C information.
System Update	1.2.8	Checks, installs and safely rolls back OSPy updates from stable or beta Git branches with backup and watchdog protection.
System Watchdog	1.0.0	Configures and monitors the Raspberry Pi hardware watchdog to recover from system lockups.
Usage Statistics	1.0.1	Downloads and displays anonymized public OSPy usage statistics.

Utilities and development examples

Plug-in	Version	What it does
Label Maker	1.0.0	Generates EAN13 barcodes and configurable QR code images.
Proto	1.0.0	Provides a minimal working example and starting point for developing OSPy plug-ins.
Signaling Examples	1.0.0	Demonstrates OSPy and plug-in signal subscriptions and records received events.

Back to the documentation home