Skip to content

iobroker-community-adapters/ioBroker.device-watcher

Repository files navigation

Logo

ioBroker.device-watcher

GitHub license Downloads GitHub repo size Translation status
GitHub commit activity GitHub commits since latest release (by date) GitHub last commit GitHub issues
Version:
NPM version Current version in stable repository Number of Installations
Tests:
Test and Release CodeQL

Sentry

This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers. For more details and for information how to disable the error reporting see Sentry-Plugin Documentation! Sentry reporting is used starting with js-controller 3.0.

Documentation

🇬🇧 Documentation
🇩🇪 Dokumentation

Discussion and Questions

ioBroker Forum
ioBroker Discord Channel

Device-Watcher adapter for ioBroker

This is a watchdog for devices/services and adapter/instances. The adapter looks for the different information about the datapoints and create JSON & HTML lists of them:

Devices/Services:

  • devices with battery,
  • devices with low battery,
  • devices with link quality,
  • updates for devices,
  • devices offline and
  • all devices

Adapter/Instances:

  • all instances
  • deactivated instances
  • instances with error
  • available adapter updates

It's also counting them in the same categories. You can use the lists and states for Grafana, Jarvis etc for example.

Supported adapters:

Alexa2 APC UPS Ble
Deconz Enocean ESP Home
euSec FritzDect fullyBrowser
Harmony Ham Home Connect
Homematic IP Homematic RPC HS100
Philips Hue Philips Hue Extended Innogy Smarthome
Jeelink Lupusec Max! Cube
Meross MiHome MiHome Vacuum
MQTT Client Zigbee2Mqtt MQTT Nuki MusicCast
Netatmo Nuki Extended Nut
Ping Roomba Shelly
Smartgarden Sonoff Sonos
Sureflap Switchbot Ble Tado
Tapo Tradfri Unifi
Wled Yeelight Zigbee
Zigbee2MQTT Zwave ........
**If one adapter is missing, feel free to open an request [issue](https://github.com/iobroker-community-adapters/ioBroker.device-watcher/issues/new/choose) to add it.**

Notifications:

The adapter has different possibilities to send notifications:

  • A device is no longer reachable or reachable again
  • A device has reached the low battery level or the low bat state is true
  • When an update is available for a device (shelly and unifi)
  • Time based a list of offline devices
  • Time based a list of low batterie devices
  • Time based a list of devices which can be updated

Currently supported notification services are:

  • Telegram
  • Pushover
  • WhatsApp
  • Email
  • Jarvis
  • Lovelace
  • Signal
  • SynoChat
  • and also an datapoint with the last notification, so you can use it for other services which aren't supported.

Blacklist

Is it neccessary to ignore a specifice device, you can add it in the blacklist and the device-watcher will ignore it. It's possible to select:

  • Ignore in notifications
  • Ignore in main list
  • Ignore in adapter own list

Here are some images how the lists can be look like in Grafana:

list1.png list2.png list3.png

Credits

This adapter would not have been possible without the great work of Christian Behrends mail@christian-behrends.de who implemented the initial releases of this adapter.

Changelog

WORK IN PROGRESS

  • (copilot) Adapter requires admin >= 7.7.22 now

2.15.5 (2026-01-12)

  • (arteck) fix admin

2.15.4 (2026-01-11)

  • (arteck) define subscribe rules new

2.15.3 (2026-01-10)

  • (arteck) fix ping adapter, fritzdec

2.15.2 (2026-01-10)

  • (arteck) fix cronjob response

2.15.1 (2026-01-10)

  • (arteck) fix instance check
  • (arteck) fix admin json

License

MIT License

Copyright (c) 2025-2026 iobroker-community-adapters iobroker-community-adapters@gmx.de
Copyright (c) 2025 Christian Behrends mail@christian-behrends.de

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.