iobroker.flowers
v0.4.8
Published
ioBroker adapter for monitoring indoor plants via soil moisture, temperature and battery sensors with Telegram notifications
Readme
ioBroker.flowers

Monitor indoor plants via soil moisture, temperature and battery sensors with Telegram notifications.
This adapter works with any sensor already integrated in ioBroker (Zigbee, Wi-Fi, Bluetooth, Z-Wave, etc.) — no specific hardware required. Popular compatible sensors:
- Xiaomi Mi Flora / HHCC Plant Sensor — Bluetooth soil moisture + temperature + light
- Zigbee soil moisture sensors (e.g. Tuya TS0601, MOES) — via ioBroker Zigbee adapter
- Any sensor exposing humidity/temperature/battery states in ioBroker
Notifications are sent via the ioBroker Telegram adapter.
Features
- Monitor multiple plants with individual sensor assignments
- Built-in plant profiles (Ficus, Orchid, Cactus, Monstera, Fern, Succulent, Palm, Pothos, Aloe Vera, Peace Lily, Coffea arabica, Rhapis excelsa, Calathea zebrina, Sansevieria Laurentii, Custom)
- Custom profiles: create your own plant profiles with individual thresholds in the Profiles tab
- Configurable thresholds per plant (override profile defaults)
- Automatic watering: trigger a watering switch when soil humidity drops below minimum
- Configurable watering duration (minutes)
- Telegram notifications via
sendTo('telegram.X', ...) - Anti-spam: max messages per day limit + configurable cooldown per alert type
- Night mode: suppress notifications during quiet hours
- Daily and weekly plant status reports with manual trigger buttons
- Offline sensor detection
Configuration
Settings Tab
| Parameter | Description | |-----------|-------------| | Telegram Instance | Instance number of the telegram adapter | | Telegram Users | Comma-separated usernames (empty = all users) | | Check Interval | How often to check sensor values | | Max Messages per Day | Anti-spam limit | | Offline Threshold | Hours before sensor is considered offline | | Night Mode | Suppress notifications during night hours | | Daily/Weekly Report | Scheduled status reports |
Plants Tab
Add your plants and assign ioBroker state IDs for each sensor. Select a profile — thresholds are applied automatically. You can override individual threshold values per plant.
For automatic watering, assign a Watering state ID (e.g. a switch that controls a pump or valve). When soil humidity drops below the minimum threshold, the adapter sets this state to true for the configured watering duration, then sets it back to false.
Profiles Tab
Overview of built-in profiles with recommended thresholds. You can also create custom profiles in the table at the top — enter a name and thresholds, then use that name in the "Custom Profile" field in the Plants tab.
States
The adapter creates states under flowers.X.plants.<plant_name>:
| State | Description |
|-------|-------------|
| humidity | Current soil humidity % |
| temperature | Current temperature °C |
| battery | Current battery % |
And under flowers.X:
| State | Description |
|-------|-------------|
| info.connection | Adapter connection status |
| notifications.totalToday | Notifications sent today |
| notifications.sendDailyReport | Button: trigger daily report manually |
| notifications.sendWeeklyReport | Button: trigger weekly report manually |
Automatic Watering
Assign a Watering state (e.g. zigbee.0.pump.state) in the Plants tab. When humidity drops below the minimum:
- The adapter sets the watering state to
true - Waits for the configured Watering Duration (minutes)
- Sets the state back to
false
Only one watering cycle runs at a time per plant. Configure the duration in Settings → Automatic Watering.
Changelog
0.4.8
- (sadam6752-tech) Fix W1032: reduce common.news to the latest 7 entries
0.4.7
- (sadam6752-tech) Fix W0037: update @iobroker/testing to 6.3.0
0.4.6
- (sadam6752-tech) Fix E6029/W6030: add the missing changelog entry for 0.4.5
- (sadam6752-tech) Fix W6034: complete MIT license text in the README
- (sadam6752-tech) CI: Node.js 26 in the test matrix and a new deploy job using npm Trusted Publishing (OIDC) with provenance
0.4.5
- (sadam6752-tech) Fix S0064: update @alcalzone/release-script-plugin-license to 5.2.2
0.4.4
- (sadam6752-tech) Fix S0082: update @tsconfig/node22 devDependency to 22.0.5
0.4.3
- (sadam6752-tech) Fix W0034: update declared @iobroker/adapter-core range to ^3.4.3
- (sadam6752-tech) Fix S5601: migrate i18n to short format ({lang}.json)
- (sadam6752-tech) Fix W1032: trim news to 7 entries
0.4.2
- (sadam6752-tech) Update @iobroker/adapter-core to 3.4.3
- (sadam6752-tech) Downgrade @types/node to ^22 (fix W0066)
- (sadam6752-tech) Add @tsconfig/node22 with extends in tsconfig.json (fix S0085/S0088)
- (sadam6752-tech) Trim old news entries (fix W1032)
0.4.1 (2026-06-20)
- (sadam6752-tech) Fix W5612: add missing i18n keys for Custom Profiles and placeholder fields
- (sadam6752-tech) Update engines.node to >=22; remove Node.js 20 from test matrix
- (sadam6752-tech) Add prettier.config.mjs, tsconfig.json, @types/node; update devDependencies
0.4.0 (2026-05-14)
- (sadam6752-tech) Fix object hierarchy: change plants container from
channeltofoldertype to allow device children
0.3.9 (2026-04-30)
- (sadam6752-tech) Fix button state roles: set
read=falseforsendDailyReportandsendWeeklyReportbuttons (required by ioBroker role spec)
0.3.8 (2026-04-30)
- (sadam6752-tech) Auto-cleanup: remove ioBroker objects for plants deleted from config on adapter start
0.3.7 (2026-04-30)
- (sadam6752-tech) Fix E8915: add dependabot cooldown (
default-days: 7) for npm ecosystem - (sadam6752-tech) Update CI/CD:
check-and-lintanddeploysteps to Node.js 24.x - (sadam6752-tech) Remove redundant
eslintdevDependency (included via@iobroker/eslint-config) - (sadam6752-tech) Add CHANGELOG_OLD.md for older changelog entries
0.3.6 (2026-03-31)
- (sadam6752-tech) Fix dependabot config to track all package.json in subdirectories (W8905)
- (sadam6752-tech) Add .github/auto-merge.yml for dependabot automerge configuration (S8914)
0.3.5 (2026-03-31)
- (sadam6752-tech) Fix .releaseconfig.json plugins format (array instead of object)
0.3.4 (2026-03-31)
- (sadam6752-tech) Add unit tests for MonitorService, NotificationManager and messages (106 tests total)
- (sadam6752-tech) Update README with links to compatible devices and Telegram adapter
- (sadam6752-tech) Remove mocha from devDependencies (already included in @iobroker/testing)
0.3.3 (2026-03-30)
- (sadam6752-tech) Fix object hierarchy: create device/channel parent objects before states
- (sadam6752-tech) Use correct state roles: value.humidity, value.temperature, value.battery
- (sadam6752-tech) Improve unload: null timers after clearing, guard monitor null check
0.3.2 (2026-03-30)
- (sadam6752-tech) Custom profiles: users can create own plant profiles in Profiles tab
- (sadam6752-tech) Custom profile field in Plants table for direct profile name entry
For older changelog entries see CHANGELOG_OLD.md.
License
MIT License
Copyright (c) 2025-2026 sadam6752-tech [email protected]
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.
