Vaskivskyi / asusrouter

API wrapper for communication with ASUSWRT-powered routers using HTTP protocol
Apache License 2.0
51 stars 6 forks source link
asus asus-routers asuswrt asuswrt-merlin

GitHub Release License
Downloads Commit activityBuy Me A Coffee

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
GT-BE98 Pro 💛 Expected to work find it
RT-BE88U 💛 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

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 💚 Confirmed Stock:
  • 388_22068
  • find it
    ZenWiFi ET8 💚 Confirmed Stock:
  • 388.23759
  • find it
    ZenWiFi Pro ET12 💚 Confirmed Stock:
  • 388.23013
  • 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
  • 388.4_0
  • find it
    GT-AX11000 Pro 💚 Confirmed Stock:
  • 388.24198
  • find it
    GT-AX6000 💛 Expected to work find it
    GT6 💛 Expected to work 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.50410
  • 386.52041
  • find it
    RT-AX56U 💚 Confirmed Merlin:
  • 386.7_2
  • 388.1_0
  • 388.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.49674
  • 388.22237
  • Merlin:
  • 386.7_2
  • 388.1_0
  • 388.4_0
  • 388.7.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
  • Merlin:
  • 386.7_2
  • find it
    RT-AX86U 💚 Confirmed Stock:
  • 386.46061
  • 386.48260
  • 386.49447
  • 388.22525
  • Merlin:
  • 386.7_2
  • 388.4_0
  • find it
    RT-AX86U Pro 💚 Confirmed Stock:
  • 388.23565
  • find it
    RT-AX88U 💚 Confirmed Stock:
  • 386.45934
  • 386.48631
  • 388.24198
  • Merlin:
  • 386.5_2
  • 386.8_0
  • 388.1_0
  • 388.2_0
  • 388.4_0
  • 388.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.50224
  • 388.21224
  • 388.22525
  • 388.23285
  • Merlin:
  • 388.4_0
  • find it
    TUF-AX6000 💚 Confirmed Stock:
  • 388.32432
  • find it
    ZenWiFi AX (XT8) 💚 Confirmed Stock:
  • 386.48706
  • 388.23285
  • Merlin:
  • 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 💚 Confirmed Stock:
  • 388_23285
  • find it

    WiFi 5 | 802.11ac

    Model Status Tested firmware Find it on Amazon[^amazon]
    4G-AC55U 💚 Confirmed Stock:
  • 380.8102
  • find it
    DSL-AC68U 💚 Confirmed Stock:
  • 386.47534
  • 386.50117
  • Merlin:
  • 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 Stock:
  • 386.51255
  • find it
    RT-AC68U 💚 Confirmed Stock:
  • 386.49703
  • Merlin:
  • 386.5_2
  • 386.7_0
  • find it
    RT-AC85P 💚 Confirmed Stock:
  • 382.52516
  • find it
    RT-AC86U 💚 Confirmed Stock:
  • 386.48260
  • 386.49709
  • Merlin:
  • 386.7_0
  • 386.7_2
  • 386.9_0
  • find it
    RT-AC87U 💚 Confirmed Merlin:
  • 384.13_10
  • find it
    RT-AC88U 💚 Confirmed Stock:
  • 386.48260
  • Merlin:
  • 386.5_0
  • 386.7_beta1
  • 386.12_2
  • 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.

    Buy Me A Coffee

    [^amazon]: As an Amazon Associate I earn from qualifying purchases. Not like I ever got anything yet (: