iobroker.asuswrt
v1.0.3
Published
find active devices in asus wrt routers for ioBroker
Readme

ioBroker.asuswrt
=================
ASUSWRT adapter for ioBroker
Find Active Devices in ASUS Routers running ASUSWRT. You can use this for Example as Presence Detection of Phones to track if someone is at home.
Tested with Asus GT-AC5300 running ASUSWRT 3.0.0.4.384_32799
You can find a list from Asus which Router DO NOT use ASUSWRT here: https://event.asus.com/2013/nw/ASUSWRT/
Requirements
You must activate and allow SSH Connections in your Router Settings
You need at least:
- js-controller >= 6.0.11
- admin >= 7.6.17
- Node.js >= 18.x
For older ioBroker versions, install version 0.3.1
Setup
- Asus Router IP-Address (Mandatory)
- The IP-Address of the Asus Router
- Login User (Mandatory)
- The Username for the Asus Router to login
- Login Password (Optional if Private Key File used)
- The Passwort for the User to login
- When you use Private Key File leave this field empty
- Private Key File (Optional if Password is used)
- When you don´t want to use Passwort-Login you can set the Path to the Private Key File for the SSH-Login
- Leave empty if not wanted
- Private Key File Passphrase (Optional if Private Key File is Encrypted)
- When your Key File is encrypted with a Passphrase then enter it here
- Leave empty if not necessary
- SSH-Port (Mandatory)
- The Port for the SSH Connection to the Asus Router
- Polling Time
- The Time in ms to check for active Devices (Mininum time is 5000ms = 5s)
- Time Not Active
- The Time in ms when a Device is not active anymore.
- In my case 180000ms = 180s = 3 Minutes works perfectly. Minimum is 60000ms
- Addresses to monitoring
- Add the Devices to watch if active or not with the MAC-Address from the Device.
- Don´t forget to set the Checkbox to activate the monitoring
Changelog
1.0.3 (2025-10-11)
- (mcdhrts) Migrated to modern i18n format with separate translation files in admin/i18n/ directory
- (mcdhrts) Migrated from HTML-based admin interface to JSON Config system (Admin 5+) for better user experience
- (mcdhrts) Fixed critical issue where admin folder was not included in npm package (404 error on jsonConfig.json)
- (mcdhrts) Fixed + button not responding in device monitoring table
- (mcdhrts) Improved parsing of ip neigh command output for better device detection
- (mcdhrts) Fixed all ioBroker repository checker issues (E5507, W4042, W4044)
- (mcdhrts) Added comprehensive configuration validation with min/max values
- (mcdhrts) Added VS Code settings with JSON schema definitions for better development experience
- (mcdhrts) Removed invalid i18n property from io-package.json
- (mcdhrts) Updated release configuration format to dictionary
1.0.2 (2025-10-05)
- (mcdhrts) Fixed admin UI 404 error - renamed index_m.html to index.html
- (mcdhrts) Updated requirements documentation to reflect current dependencies (js-controller >= 6.0.11, admin >= 7.6.17, Node.js >= 18.x)
- (mcdhrts) Improved integration tests with proper test harness and configuration validation
- (mcdhrts) Removed deprecated unit tests in favor of modern integration tests
- (mcdhrts) Updated dependencies: ssh2 ^1.4.0 -> ^1.17.0, @iobroker/adapter-core ^3.3.1 -> ^3.3.2, @iobroker/testing ^5.0.4 -> ^5.1.1
- (mcdhrts) Removed deprecated devDependencies: gulp, mocha, chai (now handled by @iobroker/testing)
1.0.1 (2019-03-22)
- (mcdhrts) Add Support for Compact Mode
1.0.0 (2019-01-13)
- (mcdhrts)
- Add possibility to use SSH Private Key File instead of Password.
- Minimum Polling Time down to 5 Seconds.
- Removed Simple-SSH Support.
- Removed Admin V2 Support.
0.3.1 (2019-01-03)
- (mcdhrts) Changed Test Files, no features added
0.3.0 (2018-12-31)
- (mcdhrts) Code Review Changes, when using SSH2 Polling Intervall is lower to now minimum 10s
0.2.1 (2018-12-29)
- (mcdhrts) Update Readme and add missing translations
0.2.0 (2018-12-17)
- (mcdhrts) Possibilty to use SSH2 which keeps the SSH Session to the Router alive
0.1.2 (2018-12-10)
- (mcdhrts) Update wrong dependencies
0.1.1 (2018-12-10)
- (mcdhrts) Update README
0.1.0 (2018-12-10)
- (mcdhrts) first complete checked and running beta Version
0.0.1 (2018-12-09)
- (mcdhrts) first official beta version
License
The MIT License (MIT)
Copyright (c) 2025 mcdhrts [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.

