Add service status detection and improve tray icon feedback

Signed-off-by: Hans Kokx <hans.d.kokx@gmail.com>
2026-06-02 14:14:43 +02:00
parent dbee65337b
commit 0a01fbc59a
2 changed files with 217 additions and 12 deletions
@@ -93,3 +93,23 @@ chmod +x ~/.local/bin/nextdns-tray
 mkdir -p ~/.config/autostart
 cp ~/.local/share/applications/nextdns-tray.desktop ~/.config/autostart/
 ```
+
+## Status Detection
+
+The tray distinguishes between service state and real DNS usage.
+
+- `Stopped`: NextDNS service is not running.
+- `Running / Not In Use`: service is running, but resolver settings do not point to NextDNS.
+- `Running / Usage Unknown`: service is running and resolver looks correct, but live verification is temporarily unavailable.
+- `Running / In Use`: service is running and usage is verified.
+
+Verification model:
+
+- Fast local checks run on each refresh cycle.
+- End-to-end validation uses `https://test.nextdns.io` and is cached for 30 seconds.
+- A start/restart action forces an immediate end-to-end re-check.
+
+Notes:
+
+- This validates host DNS routing; application-specific DoH settings may bypass host resolver behavior.
+- `curl` is used for the end-to-end check. If unavailable, status may appear as `Usage Unknown`.