API wrapper for communication with ASUSWRT-powered routers using HTTP protocol
Project description
AsusRouter
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 only used for the custom AsusRouter Home Assistant integration. But I am always open to making it suitable for any other use.
Installation
Installation of the latest release is available from PyPI:
pip install asusrouter
Usage
Once installed, you can import the AsusRouter
class from the module. Example shows the default parameters except for host
, username
and password
.
from asusrouter import AsusRouter
router = AsusRouter(host = "router.my.address", #required - both IP and URL supported
username = "admin", #required
password = "password", #required
port = None, #optional - default port would be selected based on use_ssl parameter
use_ssl = False, #optional
cache_time = 5) #optional
Supported devices
AsusRouter supports virtually every AsusWRT-powered device.
WiFi 7 | 802.11be
Model | Status | Tested firmware | Find it on Amazon[^amazon] |
---|---|---|---|
GT-BE98 | ๐ Expected to work | find it | |
RT-BE96U | ๐ Expected to work | find it |
WiFi 6e | 802.11axe
Model | Status | Tested firmware | Find it on Amazon[^amazon] |
---|---|---|---|
GT-AXE11000 | ๐ Expected to work | find it | |
GT-AXE16000 | ๐ Confirmed | Stock:388.21617 |
find it |
RT-AXE7800 | ๐ Expected to work | find it | |
ZenWiFi ET8 | ๐ Expected to work | find it | |
ZenWiFi Pro ET12 | ๐ Expected to work | find it |
WiFi 6 | 802.11ax
Model | Status | Tested firmware | Find it on Amazon[^amazon] |
---|---|---|---|
DSL-AX82U | ๐ Confirmed | Merlin:386.07_0-gnuton0_beta2 |
find it |
GT-AX11000 | ๐ Confirmed | Merlin:386.7_2 388.1_0 |
find it |
GT-AX11000 Pro | ๐ Expected to work | find it | |
GT-AX6000 | ๐ Expected to work | find it | |
GT6 | ๐ Expected to work | find it | |
RT-AX55 | ๐ Confirmed | Stock:386.50410 |
find it |
RT-AX56U | ๐ Confirmed | Merlin:386.7_2 |
find it |
RT-AX57 | ๐ Expected to work | find it | |
RT-AX58U | ๐ Confirmed | Stock:386.49674 388_22237 386.7_2 388.1_0 |
find it |
RT-AX59U | ๐ Expected to work | find it | |
RT-AX68U | ๐ Confirmed | Stock:388.21732 |
find it |
RT-AX82U | ๐ Confirmed | Stock:386.48664 386.49674 |
find it |
RT-AX86S | ๐ Confirmed | Stock:386.46061 386.48260 386.49447 388.22525 386.7_2 |
find it |
RT-AX86U | ๐ Confirmed | Stock:386.46061 386.48260 386.49447 388.22525 386.7_2 |
find it |
RT-AX86U Pro | ๐ Expected to work | find it | |
RT-AX88U | ๐ Confirmed | Stock:386.45934 386.48631 386.5_2 386.8_0 388.1_0 |
find it |
RT-AX88U Pro | ๐ Expected to work | find it | |
RT-AX89X | ๐ Confirmed | find it | |
RT-AX92U | ๐ Confirmed | Stock:386.46061 |
find it |
TUF-AX4200 | ๐ Expected to work | find it | |
TUF-AX5400 | ๐ Confirmed | Stock:386.50224 388.21224 |
find it |
TUF-AX6000 | ๐ Expected to work | find it | |
ZenWiFi AX (XT8) | ๐ Confirmed | Stock:386.48706 386.7_2-gnuton1 |
find it |
ZenWiFi AX Hybrid (XP4) | ๐ Expected to work | find it | |
ZenWiFi AX Mini (XD4) | ๐ Confirmed | Stock:386.48790 386.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 | ๐ Expected to work | find it | |
ZenWiFi XD6 | ๐ Confirmed | Stock:388.21380 |
find it |
ZenWiFi XD6S | ๐ Confirmed | Stock:388.21380 |
find it |
ZenWiFi XT9 | ๐ Expected to work | find it |
WiFi 5 | 802.11ac
Model | Status | Tested firmware | Find it on Amazon[^amazon] |
---|---|---|---|
4G-AC55U | ๐ Confirmed | find it | |
DSL-AC68U | ๐ Confirmed | Stock:386.47534 386.4-gnuton2 386.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 | find it | |
RT-AC68U | ๐ Confirmed | Stock:386.49703 386.5_2 386.7_0 |
find it |
RT-AC85P | ๐ Confirmed | Stock:382.52516 |
find it |
RT-AC86U | ๐ Confirmed | Stock:386.48260 386.7_0 386.7_2 386.9_0 |
find it |
RT-AC87U | ๐ Confirmed | Merlin:384.13_10 |
find it |
RT-AC88U | ๐ Confirmed | Merlin:386.7_beta1 |
find it |
RT-ACRH17 | ๐ Confirmed | Stock:382.52517 |
find it |
ZenWiFi AC Mini(CD6) | ๐ Expected to work | find it |
WiFi 4 | 802.11n
Model | Status | Tested firmware | Find it on Amazon[^amazon] |
---|---|---|---|
RT-N66U | ๐ Confirmed | find it |
Support the library
Issues and Pull requests
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!
Check it with your device
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.
Other support
This library is a free-time project. If you like it, you can support me by buying a coffee.
[^amazon]: As an Amazon Associate I earn from qualifying purchases. Not like I ever got anything yet (:
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for asusrouter-0.20.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0167933accd4ecbd7cf57177990d91d283f1b6d5d7b2f54d310099cf528df668 |
|
MD5 | 5766278a580f98dc34739b84b831a18e |
|
BLAKE2b-256 | 61ee30a8497a55f8eb6000cb47b5d282b1f0bae3c32f698682de91264ecdd520 |