An open API service indexing awesome lists of open source software.

https://github.com/iobroker-community-adapters/iobroker.device-watcher

Watchdog for adapter/instances and devices/services.
https://github.com/iobroker-community-adapters/iobroker.device-watcher

device device-watcher devices home-automation iobroker lists notifications smarthome watchdog

Last synced: about 1 month ago
JSON representation

Watchdog for adapter/instances and devices/services.

Awesome Lists containing this project

README

          

![Logo](admin/device-watcher.png)

# ioBroker.device-watcher

[![GitHub license](https://img.shields.io/github/license/iobroker-community-adapters/ioBroker.device-watcher)](https://github.com/iobroker-community-adapters/ioBroker.device-watcher/blob/main/LICENSE)
[![Downloads](https://img.shields.io/npm/dm/iobroker.device-watcher.svg)](https://www.npmjs.com/package/iobroker.device-watcher)
![GitHub repo size](https://img.shields.io/github/repo-size/iobroker-community-adapters/ioBroker.device-watcher)
[![Translation status](https://weblate.iobroker.net/widgets/adapters/-/device-watcher/svg-badge.svg)](https://weblate.iobroker.net/engage/adapters/?utm_source=widget)
![GitHub commit activity](https://img.shields.io/github/commit-activity/m/iobroker-community-adapters/ioBroker.device-watcher)
![GitHub commits since latest release (by date)](https://img.shields.io/github/commits-since/iobroker-community-adapters/ioBroker.device-watcher/latest)
![GitHub last commit](https://img.shields.io/github/last-commit/iobroker-community-adapters/ioBroker.device-watcher)
![GitHub issues](https://img.shields.io/github/issues/iobroker-community-adapters/ioBroker.device-watcher)

**Version:**
[![NPM version](https://img.shields.io/npm/v/iobroker.device-watcher.svg)](https://www.npmjs.com/package/iobroker.device-watcher)
![Current version in stable repository](https://iobroker.live/badges/device-watcher-stable.svg)
![Number of Installations](https://iobroker.live/badges/device-watcher-installed.svg)

**Tests:**
![Test and Release](https://github.com/iobroker-community-adapters/ioBroker.device-watcher/workflows/Test%20and%20Release/badge.svg)
[![CodeQL](https://github.com/iobroker-community-adapters/ioBroker.device-watcher/actions/workflows/codeql.yml/badge.svg)](https://github.com/iobroker-community-adapters/ioBroker.device-watcher/actions/workflows/codeql.yml)

## 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](https://github.com/ioBroker/plugin-sentry#plugin-sentry)! Sentry reporting is used starting with js-controller 3.0.

## Documentation

🇬🇧 [Documentation](/docs/en/README.md)
🇩🇪 [Dokumentation](/docs/de/README.md)

## Discussion and Questions

[ioBroker Forum](https://forum.iobroker.net/topic/55426/test-adapter-device-watcher-v1-x-x-github-latest)
[ioBroker Discord Channel](https://discord.com/channels/743167951875604501/1030196924944486530)

## 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](admin/images/list1.png)
![list2.png](admin/images/list2.png)
![list3.png](admin/images/list3.png)

## Credits

This adapter would not have been possible without the great work of Christian Behrends who implemented the initial releases of this adapter.

## Changelog

### 2.15.15 (2026-05-13)
* (arteck) fix adapter device mix

### 2.15.14 (2026-05-13)
* (arteck) fix high i/o

### 2.15.13 (2026-05-13)
* (arteck) fix new devices

### 2.15.12 (2026-05-06)
* (arteck) fix hueExtended battery check

### 2.15.11 (2026-05-06)
* (arteck)

## License

MIT License

Copyright (c) 2025-2026 iobroker-community-adapters
Copyright (c) 2025 Christian Behrends

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.