MiWiFi (Xiaohack Edition) for Home Assistant (Marketplace integration)

On Home Assistant 2026.11 or newer? Open it in the Marketplace

Installs: 326 sharing analytics
GitHub stars: 89
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v3.13.3, October 28, 2026
Category: Presence and location
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: miwifi
Source: github.com/JuanManuelRomeroGarcia/hass-miwifi
Issues: Report an issue

Shows in Vulpo Light card, Quick Toggle card, Button card, Select card, Apple Watch, Control Center.

Download Vulpo

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

MiWiFi for Home Assistant

Description from JuanManuelRomeroGarcia/hass-miwifi

Shows in Vulpo

Light card, Quick Toggle card, Button card, Select card, Apple Watch, Control Center.

Download Vulpo

Supports

Works locallyTalks to your devices on your own network. No vendor cloud in between.
Found by itselfHome Assistant spots it on the network and offers to add it.
Device triggersIts devices can start automations directly.
From the MarketplaceInstalled through the Marketplace, formerly HACS.
Actively maintainedIts author released or pushed a change in the last six months.

Provides

Lights
Switches
Sensors
Presence

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

MiWiFi settings

IP address
Password
Password encryption algorithm
Track devices
Minimum stay online in secondsKeep a client home for this many seconds after its last observation. Must be at least scan interval + request timeout. Start with 60 s; slow meshes may need more. Larger values delay departure detection.
Scan interval in seconds [PRO]Time between scheduled polls. Requests add time, so actual readings may be farther apart. Lower values increase router load; allow enough presence time for the slowest reporting node.
Timeout of requests in seconds [PRO]How long to wait for a router request. Some endpoints use shorter limits; this is not the maximum duration of a complete poll. It is separate from presence time.
WAN speed unit
Forced loading of devices in repeater mode [PRO]
Allowed days since last activity [PRO]
Log level (global)
Enable control panel
Create device sensors (clients)
Enable port probing (80/443) for device configuration URL
Access point / mesh node (skip WAN and gateway endpoints)

Reauthenticate MiWiFi

Password

After setup

Enable control panel
Log level (global)
Auto-purge every X days (0 = disabled) [PRO]
Daily auto-purge time (HH:MM) [PRO]
Create sensors for connected devices (clients)
IP address
Password
Password encryption algorithm
Track devices
Minimum stay online in secondsKeep a client home for this many seconds after its last observation. Must be at least scan interval + request timeout. Start with 60 s; slow meshes may need more. Larger values delay departure detection.
Scan interval in seconds [PRO]Time between scheduled polls. Requests add time, so actual readings may be farther apart. Lower values increase router load; allow enough presence time for the slowest reporting node.
Allowed number of days to wait after the last activity [PRO]
Timeout of requests in seconds [PRO]How long to wait for a router request. Some endpoints use shorter limits; this is not the maximum duration of a complete poll. It is separate from presence time.
WAN speed unit
Forced booting of devices in repeater mode [PRO]
Enable port probing (80/443) for device configuration URL
Protocol
Access point / mesh node (skip WAN and gateway endpoints)

Texts from the code of JuanManuelRomeroGarcia/hass-miwifi.

Entities

SensorsIP address, Connection, Connected time, Download speed, Upload speed, Total usage, Signal, Signal quality, Last activity, First seen, Internet blocked, Wi-Fi protocol, and 2 more

Actions

Generate router dumpGenerates a JSON file with information from the main router.
- Include system data
- Include network data
- Include connected devices
- Include NAT rules
- Include QoS configuration
- Include Wi-Fi configuration
- Anonymize IP/MAC addresses and names
- Fresh API queries and responses (main + nodes)
Purge inactive devicesRemoves device_trackers and orphan devices after X days of inactivity.
- Limit to these MAC addresses
- Inactivity days
- Only randomized MACs
- Include orphan devices
- Include orphans without timestamp
- Detailed mode
- Apply changes
Get Wi-Fi configuration (panel)Returns the current Wi-Fi configuration for the selected router or the main router.
Configure Guest Wi-FiEnables or disables guest Wi-Fi and optionally changes its network settings.
Test Guest Wi-FiReads the guest Wi-Fi status from the selected router or the main router.
Configure Wi-Fi (2.4G/5G/Game)Changes the settings of one or more Wi-Fi bands on the selected router or the main router.

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.
System healthAdds its status to Home Assistant's system information.

From the README

Help test Xiaomi router compatibility / Ayuda a comprobar tu router
Run the optional PC tools and share reviewed reports in Discussion #374. No test integration installation is required.

From the README of JuanManuelRomeroGarcia/hass-miwifi, Apache License 2.0. Shortened.