mirror of
https://github.com/jokob-sk/NetAlertX.git
synced 2026-03-31 07:12:23 -07:00
3b1b853b14
- Introduce native Ookla Speedtest binary support for Gigabit connections - Add intelligent engine detection with automatic fallback to python-cli version - Map full JSON payload to Watched_Value3 for n8n integration - Add Spanish (es_es) localizations and update README instructions
Overview
A plugin allowing for executing regular internet speed tests.
Usage
This plugin supports two engines:
- Baseline Engine: Uses the Python
speedtest-clilibrary (default). - Native Engine (Optimized): Uses the native Ookla Speedtest binary.
Opt-in for Native Engine
To use the native engine:
- Provide the native
speedtestbinary in your environment: Speedtest CLI Homepage - Map the binary to
/usr/bin/speedtestin the container. - Ensure the native speedtest binary is installed on the host at the source path.
volumes:
- /usr/bin/speedtest:/usr/bin/speedtest:ro
- The plugin will automatically detect and use it for subsequent tests.
Data Mapping
- Watched_Value1 — Download Speed (Mbps).
- Watched_Value2 — Upload Speed (Mbps).
- Watched_Value3 — Full JSON payload (useful for n8n or detailed webhooks).
Notes
- The native binary is recommended for connections > 100 Mbps.
- If the native binary is not detected, the plugin seamlessly falls back to the baseline library.