JB_1366
Regular Contributor
WIRELESS REPORT
Official Release April 11, 2026
WHAT IS IT FOR: WIRELESS REPORT gives you an overall snapshot of your wireless network in a sortable/graphical table, including signal strength (RSSI) of connected devices on nodes, details which the ASUS Network Map lacks. The report script installs a tab at the end of the Wireless menu in the ASUS WebGUI, where you can click column headers to sort/view data associated with connected devices. Several of the columns are designed for alternate viewing options, e.g. MAC address / IP address and SSID / Wireless INTERFACE.
WHY: The reason I created the script was because the ASUS WebGUI does not show AiMesh node information. The absence of the RSSI parameter on nodes was actually the main reason I started this addon. It is also useful to see all wireless devices in one tab, on one table or side by side. ASUS firmware takes way too long to adjust devices to connect to the correct router/node; using the report, I can manually adjust the connectivity of client devices easier and faster.
PREREQUISITES: As one of the main reasons for using WIRELESS REPORT is to view connection details on nodes, if your system has a MAIN Router and one or more nodes, for WIRELESS REPORT to be able to access node data, you will need to install password-less SSH access to each node.
For password-less SSH access refer the steps in post #16 of this thread prior to installing WIRELESS REPORT.
As noted above, this method applies equally to nodes running stock FW or Merlin FW. Only the MAIN must be running Merlin FW.
NON-PREREQUISITES:
Whilst not an absolute, if you would like your WIRELESS REPORT tables to show pretty-looking HOSTNAMES rather than the default MAC addresses, you should consider manually assigning often used, known Clients with "Manually Assigned IP addresses" by populating your LAN DHCP reservations in the LAN, DHCP Server Tab and (if you have GNP) in the Guest Network Pro, <Selected Guest Network>, Advanced Settings, Manually Assigned IP around the DHCP lists option of the WebGUI.
As the MAIN will be running Merlin anyway, whilst you can use the Stock WebGUI for this, consider installing YazDHCP, an easier to use interface for manual assignments, that can import and export DHCP assignments and combines both MAIN and GNP manual assignments into one interface. YazDHCP is not the subject of this addon, but can be installed via amtm (option j7).
INSTALLATION:
Installation takes two mandatory steps, followed by some optional configuration.
Step 1. Initiate the installation.
There are two ways to initiate the addon installation:
i. Via AMTM; from the amtm menu, simply select "wr".
OR
ii. Manually, via SSH, from the MAIN Router.
Note that both methods only initiate the install screen, the installation is NOT COMPLETE at this point.
Once the install is initiated into amtm, you will be presented with the upper part of this screen, with menu items (1) to (4) and (e):
Step 2: Run the actual WR install (1). You will only need to do this once, and on subequent updates :
i.e. Select option (1). You will see:
OPTIONAL CONFIGURATION (in WR menu):
As per the screenshot above, there are two items (3) and (4) to configure.
RT-AX88U_Pro → RT-AX88U_Pro (MAIN)
RT-AX3000 → RT-AX3000 (Node)
Using Nicknames:
Master Bedroom → Master Bedroom (MAIN)
Kat's Room → Kat's Room (NODE)
RT-AX88U_Pro (MB) → RT-AX88U_Pro (MB) (MAIN)
RT-AX3000 (Kat's Room) → RT-AX3000 (Kat's Room) (Node)
VIEWING WIRELESS REPORT:
In ASUS WebGUI, simply go to Advanced Settings, Wireless, select the rightmost tab "Wireless" and click Refresh.
Viewing options include:
WIRELESS REPORT can be updated either:
(a) via amtm: from amtm simply type wr, select option (1) which will install the update then press (e) to exit.
(b) via SSH: from your terminal window, issue the cmd
You can also add an alias to the profile.add file in /jffs/configs/profile.add e.g.
and issue this to restart profle.add:
After that you can run wr or whatever alias you choose, from root.
UNINSTALLATION:
To uninstall:
(a) From amtm simply run wr, select option (2), which will uninstall the files, but will take you back to the WIRELESS REPORT Install Menu. At this point, simply exit using (e).
(b) From an SSH Terminal run:
(or your chosen alias)
then as per (a) select option (2), which will uninstall the WR files, but will take you back to the WIRELESS REPORT Install Menu. Again, at this point, simply exit using (e).
WIRELESS REPORT is free to use under the GNU General Public License version 3 (GPL 3.0).
This project is hosted on GitHub
If you have any questions, please feel free to post in the thread.
Instructions created by @jksmurf, most excellent job!!
CHANGELOG:
v1.3.8-updated USB detection, hopefully its finally fixed. for people with usb non-detected, uninstall old version, reinstall new version.
Official Release April 11, 2026
WHAT IS IT FOR: WIRELESS REPORT gives you an overall snapshot of your wireless network in a sortable/graphical table, including signal strength (RSSI) of connected devices on nodes, details which the ASUS Network Map lacks. The report script installs a tab at the end of the Wireless menu in the ASUS WebGUI, where you can click column headers to sort/view data associated with connected devices. Several of the columns are designed for alternate viewing options, e.g. MAC address / IP address and SSID / Wireless INTERFACE.
WHY: The reason I created the script was because the ASUS WebGUI does not show AiMesh node information. The absence of the RSSI parameter on nodes was actually the main reason I started this addon. It is also useful to see all wireless devices in one tab, on one table or side by side. ASUS firmware takes way too long to adjust devices to connect to the correct router/node; using the report, I can manually adjust the connectivity of client devices easier and faster.
PREREQUISITES: As one of the main reasons for using WIRELESS REPORT is to view connection details on nodes, if your system has a MAIN Router and one or more nodes, for WIRELESS REPORT to be able to access node data, you will need to install password-less SSH access to each node.
For password-less SSH access refer the steps in post #16 of this thread prior to installing WIRELESS REPORT.
As noted above, this method applies equally to nodes running stock FW or Merlin FW. Only the MAIN must be running Merlin FW.
NON-PREREQUISITES:
Whilst not an absolute, if you would like your WIRELESS REPORT tables to show pretty-looking HOSTNAMES rather than the default MAC addresses, you should consider manually assigning often used, known Clients with "Manually Assigned IP addresses" by populating your LAN DHCP reservations in the LAN, DHCP Server Tab and (if you have GNP) in the Guest Network Pro, <Selected Guest Network>, Advanced Settings, Manually Assigned IP around the DHCP lists option of the WebGUI.
As the MAIN will be running Merlin anyway, whilst you can use the Stock WebGUI for this, consider installing YazDHCP, an easier to use interface for manual assignments, that can import and export DHCP assignments and combines both MAIN and GNP manual assignments into one interface. YazDHCP is not the subject of this addon, but can be installed via amtm (option j7).
INSTALLATION:
Installation takes two mandatory steps, followed by some optional configuration.
Step 1. Initiate the installation.
There are two ways to initiate the addon installation:
i. Via AMTM; from the amtm menu, simply select "wr".
OR
ii. Manually, via SSH, from the MAIN Router.
Code:
curl -sfL --retry 3 https://raw.githubusercontent.com/JB1366/Wireless_Report/main/wirelessreport.sh -o /tmp/wirelessreport.sh && sh /tmp/wirelessreport.sh installNote that both methods only initiate the install screen, the installation is NOT COMPLETE at this point.
Once the install is initiated into amtm, you will be presented with the upper part of this screen, with menu items (1) to (4) and (e):
Step 2: Run the actual WR install (1). You will only need to do this once, and on subequent updates :
i.e. Select option (1). You will see:
- A check for USB storage;
- Status of the passwordless SSH environment you set up above as a prerequisite i.e. it will tell you if it is working correctly;
- Processing of the Wireless Report files; and
- A completion message, with a reference to use option (4) to set custom nicknames of your router devices
OPTIONAL CONFIGURATION (in WR menu):
As per the screenshot above, there are two items (3) and (4) to configure.
- Option (3) is used simply to modify your Temperature Units from F (default) to C or vice-versa; it also amends the date format to a non-US format.
- Option (4) is used to modify the names of your Router or Node.
Note that the default names are the MODEL number of your device e.g. RT-AX88U_Pro or RT-AX3000. WIRELESS REPORT suffixes the default names with (MAIN) or (NODE). If you have more than one Node, the Nodes are all named on one line, with a "|" separator. The last node is then suffixed by the term (NODES). If you amend the Router/Node name using option 4, you can call it anything you wish, within a 24 character limit. The terms (MAIN) or (NODE) will be automatically appended to any name you give it. If you wish to retain the Model number, then you must type that in as part of the new name e.g.
RT-AX88U_Pro → RT-AX88U_Pro (MAIN)
RT-AX3000 → RT-AX3000 (Node)
Using Nicknames:
Master Bedroom → Master Bedroom (MAIN)
Kat's Room → Kat's Room (NODE)
RT-AX88U_Pro (MB) → RT-AX88U_Pro (MB) (MAIN)
RT-AX3000 (Kat's Room) → RT-AX3000 (Kat's Room) (Node)
VIEWING WIRELESS REPORT:
In ASUS WebGUI, simply go to Advanced Settings, Wireless, select the rightmost tab "Wireless" and click Refresh.
- The tables will display all your connected clients, for MAIN and NODES, with HOSTNAME, IP ADDRESS (or MAC), RSSI, RX/TX, SSID (or INTERFACE), BAND and CLIENT UPTIME.
- All columns w.e.o. IP ADDRESS and SSID are alphabetically or numerically sortable.
- The total number of connected devices are shown; and the number connected to each Router/Node.
- The RSSI are graded (and colour-coded) by Excellent, Good, Fair or Poor connectivity.
Viewing options include:
- Hover over the "WIRELESS REPORT" text in the header for script version
- A dropdown for adjusting the Auto-Refresh Interval
- Tabular Viewing options "Stacked" (Default) showing MAIN, then (ALL) NODES; "All devices", without stacking and "Side by Side".
WIRELESS REPORT can be updated either:
(a) via amtm: from amtm simply type wr, select option (1) which will install the update then press (e) to exit.
(b) via SSH: from your terminal window, issue the cmd
Code:
sh /jffs/addons/wireless_report/wirelessreport.sh installYou can also add an alias to the profile.add file in /jffs/configs/profile.add e.g.
Code:
alias wr="sh /jffs/addons/wireless_report/wirelessreport.sh install" # Allows Wireless Report install script to be run from anywhere, including root.and issue this to restart profle.add:
Code:
source /jffs/configs/profile.addUNINSTALLATION:
To uninstall:
(a) From amtm simply run wr, select option (2), which will uninstall the files, but will take you back to the WIRELESS REPORT Install Menu. At this point, simply exit using (e).
(b) From an SSH Terminal run:
Code:
sh /jffs/addons/wireless_report/wirelessreport.sh installthen as per (a) select option (2), which will uninstall the WR files, but will take you back to the WIRELESS REPORT Install Menu. Again, at this point, simply exit using (e).
WIRELESS REPORT is free to use under the GNU General Public License version 3 (GPL 3.0).
This project is hosted on GitHub
If you have any questions, please feel free to post in the thread.
Instructions created by @jksmurf, most excellent job!!
CHANGELOG:
v1.3.8-updated USB detection, hopefully its finally fixed. for people with usb non-detected, uninstall old version, reinstall new version.
Last edited:
