asusrouter

Downloads Commit activity

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 mostly used for the custom AsusRouter Home Assistant integration and from recently by the core Home Assistant AsusWRT 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.

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())

Supported devices

AsusRouter supports virtually every AsusWRT-powered device.

[!TIP]
Version 388.10 of AsusWRT-Merlin firmware is officially NOT supported due to the issues with HTTP daemon crashes. Use versions >=388.10_2 or <=388.9_2.

WiFi 7 | 802.11be

Model	Status	Tested firmware	Find it on Amazon¹
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

WiFi 6e | 802.11axe

Model	Status	Tested firmware	Find it on Amazon¹
GT-AXE11000	💛 Expected to work		find it
GT-AXE16000	💚 Confirmed	Stock: `388.21617` Merlin: `388.7_beta1_rog` `388.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

WiFi 6 | 802.11ax

Model	Status	Tested firmware	Find it on 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` `388.7_0_rog`	find it
GT-AX11000 Pro	💚 Confirmed	Stock: `388.24198` Merlin: `388.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.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` Merlin: `388.8_4-gnuton1`	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` `388.7_beta1`	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` `388.24121` 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	💚 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

WiFi 5 | 802.11ac

Model	Status	Tested firmware	Find it on Amazon¹
4G-AC55U	💚 Confirmed	Stock: `380.8102`	find it
BRT-AC828	💚 Confirmed	Stock: `382_70348`	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¹
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.

As an Amazon Associate I earn from qualifying purchases. Not like I ever got anything yet (: ↩ ↩² ↩³ ↩⁴ ↩⁵

Development Status
- 3 - Alpha
Intended Audience
- Developers
Operating System
- OS Independent
Programming Language
Topic
- Software Development :: Libraries

Metadata

Development Status
- 3 - Alpha
Intended Audience
- Developers
Operating System
- OS Independent
Programming Language
Topic
- Software Development :: Libraries

Release files for asusrouter 1.21.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for asusrouter 1.21.3
File	Size	Uploaded
asusrouter-1.21.3.tar.gz	130.2 kB	Dec 9, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for asusrouter 1.21.3
File	Interpreter	ABI	Platform	Reset
asusrouter-1.21.3-py3-none-any.whl 132.1 kB Dec 9, 2025	Python 3	none	any	Details

Total release size: 262.3 kB

Release files / asusrouter-1.21.3.tar.gz

Download URL	asusrouter-1.21.3.tar.gz
Size	130.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`584063b48f2e2da2b0bb1f6bcf61abf4d77aa3450a8895ad64223babe6b21140`
BLAKE2b-256 checksum How to use checksums	`4bf6008706e00edb15697f3ac810f991d8791eeea21bd51deab4b41dc735326f`
Upload date	Dec 9, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Vaskivskyi/asusrouter
Publishing commit: github.com/Vaskivskyi/asusrouter/tree/8de97bfa8ffe3efa2f6d1ec30bb95187d13ab37a

Workflow

Publishing configuration: github.com/Vaskivskyi/asusrouter/blob/8de97bfa8ffe3efa2f6d1ec30bb95187d13ab37a/.github/workflows/release.yml
Publishing logs: github.com/Vaskivskyi/asusrouter/actions/runs/20077161940/attempts/1

Artifact

Subject: asusrouter-1.21.3.tar.gz
SHA-256 checksum: 584063b48f2e2da2b0bb1f6bcf61abf4d77aa3450a8895ad64223babe6b21140 Verifying attestations

Release files / asusrouter-1.21.3-py3-none-any.whl

Download URL	asusrouter-1.21.3-py3-none-any.whl
Size	132.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d08f302e64e9585a2c14ba1f7df06b730d8bd99a59663a0f36a16f5743f9d5f0`
BLAKE2b-256 checksum How to use checksums	`695064f14c7baa4b72bc8a01889a12d44f32a759f730ed460b48b6375dae5efa`
Upload date	Dec 9, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Vaskivskyi/asusrouter
Publishing commit: github.com/Vaskivskyi/asusrouter/tree/8de97bfa8ffe3efa2f6d1ec30bb95187d13ab37a

Workflow

Publishing configuration: github.com/Vaskivskyi/asusrouter/blob/8de97bfa8ffe3efa2f6d1ec30bb95187d13ab37a/.github/workflows/release.yml
Publishing logs: github.com/Vaskivskyi/asusrouter/actions/runs/20077161940/attempts/1

Artifact

Subject: asusrouter-1.21.3-py3-none-any.whl
SHA-256 checksum: d08f302e64e9585a2c14ba1f7df06b730d8bd99a59663a0f36a16f5743f9d5f0 Verifying attestations