link-ip-monitor

link-ip-monitor pings a list of IPs, hostnames or links on an interval, tracks each host's online/offline status and response time, and notifies when one goes down or comes back up.

Plugin

Field	Value
ID	nilsonlinux/link-ip-monitor
Entries	Bar widget: status; panel: panel; service: monitor

Requirements

Uses the system ping binary (iputils, present on most Linux distros). No other external dependency.

Usage

Add the status widget to the bar: it turns green when every monitored host is responding, red with a count badge when one or more are down, and neutral when the list is empty.

Click the widget to open the panel. Use the + button in the panel header to reveal the add-host form — accepts an IP (8.8.8.8), a hostname (example.com) or a full link (scheme, port, path and query are stripped automatically, keeping only the host to ping). An optional description can be set alongside it.

Each row in the panel shows the label (or the host, if no label was set), a status pill, the response time in ms while online, a drag handle to reorder the list, and a trash button to remove that entry (asks for confirmation). Right-click the widget, or use the refresh button in the panel, to force an immediate check.

Open the panel directly with:

noctalia msg panel-toggle nilsonlinux/link-ip-monitor:panel

Force an immediate check via IPC:

noctalia msg plugin nilsonlinux/link-ip-monitor:monitor all refresh

The host list itself is not stored in plugin settings — it lives in the service's own persisted state (pluginDataDir()/state.json) and is managed entirely from the panel (add / remove / reorder), since the plugin API has no way to write settings back from a script.

Settings

Setting	Type	Default	Description
interval_seconds	int	30	How often each host is checked.
timeout_seconds	int	1	How long to wait for a ping reply before treating it as a failure.
notify_on_recovery	bool	true	Send a notification when a host that was down responds again.
glyph (widget)	glyph	activity	Icon shown in the bar for the status widget.

Notes

Notification text and panel labels come from translations/<locale>.json via noctalia.tr() (English and pt-BR included). noctalia.notify() / noctalia.notifyError() accept only a title and body — the plugin API exposes no urgency parameter, so the "host down" alert's appearance (the red border from notifyError) can't be further customized from the plugin. Response time (ms) is parsed from ping's own text output, so it depends on that output containing a =<number> ms pattern regardless of the system's locale.