AsusRouter is an API wrapper for communication with ASUSWRT-powered routers using HTTP(S) protocols. The library supports both the stock AsusWRT firmware and AsusWRT-Merlin.
Up till now, it is mostly used for the custom AsusRouter Home Assistant integration. But I am always open to making it suitable for any other use.
Installation of the latest release is available from PyPI:
pip install asusrouter
Once installed, you can import the AsusRouter class from the module. Example shows the default parameters except for host, username and password.
import aiohttp
import asyncio
from asusrouter import AsusRouter, AsusData
# Create a new event loop
loop = asyncio.new_event_loop()
# Create aiohttp session
session = aiohttp.ClientSession(loop=loop)
router = AsusRouter( #required - both IP and URL supported
hostname="router.my.address", #required
username="admin", #required
password="password", #required
use_ssl=True, #optional
session=session, #optional
)
# Connect to the router
loop.run_until_complete(router.async_connect())
# Now you can use the router object to call methods
data = loop.run_until_complete(router.async_get_data(AsusData.NETWORK))
print(data)
# Remember to disconnect and close the session when you're done
loop.run_until_complete(router.async_disconnect())
loop.run_until_complete(session.close())
AsusRouter supports virtually every AsusWRT-powered device.
| Model | Status | Tested firmware | Find it on Amazon1 |
|---|---|---|---|
| GT-BE19000 | 💛 Expected to work | find it | |
| GT-BE98 | 💚 Confirmed | Stock:102_34372 | find it |
| GT-BE98 Pro | 💛 Expected to work | find it | |
| RT-BE58U | 💛 Expected to work | find it | |
| RT-BE88U | 💛 Expected to work | find it | |
| RT-BE92U | 💛 Expected to work | find it | |
| RT-BE96U | 💛 Expected to work | find it | |
| TUF-BE3600 | 💛 Expected to work | find it | |
| TUF-BE6500 | 💛 Expected to work | find it | |
| ZenWiFi BD4 | 💛 Expected to work | find it | |
| ZenWiFi BQ16 | 💛 Expected to work | find it | |
| ZenWiFi BQ16 Pro | 💛 Expected to work | find it | |
| ZenWiFi BT10 | 💛 Expected to work | find it |
| Model | Status | Tested firmware | Find it on Amazon1 |
|---|---|---|---|
| GT-AXE11000 | 💛 Expected to work | find it | |
| GT-AXE16000 | 💚 Confirmed | Stock:388.21617388.7_beta1_rog388.7_0_rog | find it |
| RT-AXE7800 | 💚 Confirmed | Stock:388_22068 | find it |
| ZenWiFi ET8 | 💚 Confirmed | Stock:388.23759 | find it |
| ZenWiFi ET9 | 💛 Expected to work | find it | |
| ZenWiFi Pro ET12 | 💚 Confirmed | Stock:388.23013 | find it |
| Model | Status | Tested firmware | Find it on Amazon1 |
|---|---|---|---|
| DSL-AX82U | 💚 Confirmed | Merlin:386.07_0-gnuton0_beta2 | find it |
| GT-AX11000 | 💚 Confirmed | Merlin:386.7_2388.1_0388.4_0388.7_0_rog | find it |
| GT-AX11000 Pro | 💚 Confirmed | Stock:388.24198388.7_0_rog | find it |
| GT-AX6000 | 💛 Expected to work | Merlin:388.7_beta1 | find it |
| GT6 | 💛 Expected to work | find it | |
| RP-AX56 | 💚 Confirmed | find it | |
| RT-AX3000P | 💛 Expected to work | find it | |
| RT-AX52 | 💛 Expected to work | find it | |
| RT-AX53U | 💚 Confirmed | Stock:386.69061 | find it |
| RT-AX5400 | 💛 Expected to work | find it | |
| RT-AX55 | 💚 Confirmed | Stock:386.50410386.52041 | find it |
| RT-AX56U | 💚 Confirmed | Merlin:386.7_2388.1_0388.2_2 | find it |
| RT-AX57 | 💛 Expected to work | find it | |
| RT-AX57 Go | 💛 Expected to work | find it | |
| RT-AX57M | 💛 Expected to work | find it | |
| RT-AX58U | 💚 Confirmed | Stock:386.49674388.22237386.7_2388.1_0388.4_0388.7.0 | find it |
| RT-AX59U | 💛 Expected to work | find it | |
| RT-AX68U | 💚 Confirmed | Stock:388.21732 | find it |
| RT-AX82U | 💚 Confirmed | Stock:386.48664386.49674 | find it |
| RT-AX86S | 💚 Confirmed | Stock:386.46061386.48260386.49447388.22525386.7_2 | find it |
| RT-AX86U | 💚 Confirmed | Stock:386.46061386.48260386.49447388.22525386.7_2388.4_0388.7_beta1 | find it |
| RT-AX86U Pro | 💚 Confirmed | Stock:388.23565 | find it |
| RT-AX88U | 💚 Confirmed | Stock:386.45934386.48631388.24198386.5_2386.8_0388.1_0388.2_0388.4_0388.7_0 | find it |
| RT-AX88U Pro | 💚 Confirmed | Merlin:388.4_0 | find it |
| RT-AX89X | 💚 Confirmed | find it | |
| RT-AX92U | 💚 Confirmed | Stock:386.46061 | find it |
| TUF-AX3000 V2 | 💚 Confirmed | Stock:388.23785 | find it |
| TUF-AX4200 | 💛 Expected to work | find it | |
| TUF-AX5400 | 💚 Confirmed | Stock:386.50224388.21224388.22525388.23285388.24121388.4_0 | find it |
| TUF-AX6000 | 💚 Confirmed | Stock:388.32432 | find it |
| ZenWiFi AX (XT8) | 💚 Confirmed | Stock:386.48706388.23285386.7_2-gnuton1 | find it |
| ZenWiFi AX Hybrid (XP4) | 💛 Expected to work | find it | |
| ZenWiFi AX Mini (XD4) | 💚 Confirmed | Stock:386.48790386.49599 | find it |
| ZenWiFi Pro XT12 | 💚 Confirmed | Stock:388.22127 | find it |
| ZenWiFi XD4 Plus | 💛 Expected to work | find it | |
| ZenWiFi XD4S | 💛 Expected to work | find it | |
| ZenWiFi XD5 | 💚 Confirmed | Stock:388.23949 | find it |
| ZenWiFi XD6 | 💚 Confirmed | Stock:388.21380 | find it |
| ZenWiFi XD6S | 💚 Confirmed | Stock:388.21380 | find it |
| ZenWiFi XT9 | 💚 Confirmed | Stock:388_23285 | find it |
| Model | Status | Tested firmware | Find it on Amazon1 |
|---|---|---|---|
| 4G-AC55U | 💚 Confirmed | Stock:380.8102 | find it |
| BRT-AC828 | 💚 Confirmed | Stock:382_70348 | find it |
| DSL-AC68U | 💚 Confirmed | Stock:386.47534386.50117386.4-gnuton2386.7_2-gnuton1 | find it |
| RT-AC51U | 💚 Confirmed | Stock:380.8591 | find it |
| RT-AC52U B1 | 💚 Confirmed | find it | |
| RT-AC5300 | 💚 Confirmed | Merlin:386.7_2 | find it |
| RT-AC57U V3 | 💚 Confirmed | Stock:386.21649 | find it |
| RT-AC58U | 💚 Confirmed | find it | |
| RT-AC66U | 💚 Confirmed | Merlin:380.70_0 | find it |
| RT-AC66U B1 | 💚 Confirmed | Stock:386.51255 | find it |
| RT-AC68U | 💚 Confirmed | Stock:386.49703386.5_2386.7_0 | find it |
| RT-AC85P | 💚 Confirmed | Stock:382.52516 | find it |
| RT-AC86U | 💚 Confirmed | Stock:386.48260386.49709386.7_0386.7_2386.9_0 | find it |
| RT-AC87U | 💚 Confirmed | Merlin:384.13_10 | find it |
| RT-AC88U | 💚 Confirmed | Stock:386.48260386.5_0386.7_beta1386.12_2 | find it |
| RT-ACRH17 | 💚 Confirmed | Stock:382.52517 | find it |
| ZenWiFi AC Mini(CD6) | 💛 Expected to work | find it |
| Model | Status | Tested firmware | Find it on Amazon1 |
|---|---|---|---|
| RT-N66U | 💚 Confirmed | find it |
If you have found an issue working with the library or just want to ask for a new feature, please fill in a new issue.
You are also welcome to submit pull requests to the repository!
Testing the library with different devices would help a lot in the development process. Unfortunately, currently, I have only one device available, so your help would be much appreciated.
This library is a free-time project. If you like it, you can support me by buying a coffee.
FAQs
API wrapper for communication with ASUSWRT-powered routers using HTTP protocol
We found that asusrouter demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.