# alexxit/xiaomigateway3

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/alexxit-xiaomigateway3).**

2,722 stars · 397 forks · Python · mit

## Links

- GitHub: https://github.com/AlexxIT/XiaomiGateway3
- awesome-repositories: https://awesome-repositories.com/repository/alexxit-xiaomigateway3.md

## Topics

`aqara` `ble` `hacs` `home-assistant` `matter` `mesh` `mihome` `xiaomi` `zha` `zigbee` `zigbee2mqtt`

## Description

XiaomiGateway3 is a local network interface and management tool for Xiaomi gateways. It functions as a local bridge to control Zigbee, Bluetooth Low Energy, and Matter devices while bypassing cloud reliance.

The project provides a system for managing diverse hardware protocols, including a controller for Matter-standard lighting and Bluetooth Low Energy hardware such as smart locks and presence sensors. It allows for the integration of Zigbee sensors and actuators from multiple brands using external converters to support third-party hardware.

The system includes utilities for extracting device authentication tokens and keys, as well as tools for monitoring gateway health through real-time CPU load and memory usage metrics. It supports custom hardware compatibility via external data converters and entity domain overriding to redefine how sensors and actuators report their states.

The software manages event capture for button press patterns and monitors state changes for secure hardware like smart locks.

## Tags

### Hardware & IoT

- [IoT Gateway Local Bridges](https://awesome-repositories.com/f/hardware-iot/iot-gateway-local-bridges.md) — Functions as a local network interface for controlling Xiaomi gateways and managing Zigbee, BLE, and Matter devices without cloud reliance.
- [Local Gateway Control](https://awesome-repositories.com/f/hardware-iot/local-gateway-control.md) — Establishes local network communication with hardware hubs to manage connected devices without cloud reliance. ([source](https://github.com/AlexxIT/XiaomiGateway3/blob/master/.gitignore))
- [BLE Device Management](https://awesome-repositories.com/f/hardware-iot/ble-device-management.md) — Collects data and manages state for Bluetooth Low Energy and mesh devices across multiple gateways. ([source](https://github.com/AlexxIT/XiaomiGateway3#readme))
- [Home Automation](https://awesome-repositories.com/f/hardware-iot/connectivity-iot/home-automation.md) — Captures button press patterns and sensor events to trigger custom logic and automated actions across a mesh network.
- [Local IoT Gateway Management](https://awesome-repositories.com/f/hardware-iot/local-iot-gateway-management.md) — Provides a management tool for monitoring gateway health, executing system commands, and retrieving device authentication tokens locally.
- [Matter and BLE Gateway Controllers](https://awesome-repositories.com/f/hardware-iot/matter-and-ble-gateway-controllers.md) — Provides a controller for interfacing with Matter-standard lighting and Bluetooth Low Energy hardware such as smart locks and presence sensors.
- [Multi-Vendor Hardware Integrations](https://awesome-repositories.com/f/hardware-iot/multi-vendor-hardware-integrations.md) — Aggregates and unifies data from Zigbee, BLE, and Matter hardware interfaces into a single management system.
- [Driver to Device Mapping](https://awesome-repositories.com/f/hardware-iot/driver-to-device-mapping.md) — Modifies entity domains and sensor logic to redefine how specific hardware devices function. ([source](https://github.com/AlexxIT/XiaomiGateway3/blob/master/README.md))
- [Per-Entity Behavior Overrides](https://awesome-repositories.com/f/hardware-iot/integration-performance/hardware-interfacing-integration/hardware-integration/device-sensors/custom-entity-configurators/per-entity-behavior-overrides.md) — Allows overriding sensor logic and naming conventions to modify how specific hardware entities report their states.
- [Smart Lock Event Monitors](https://awesome-repositories.com/f/hardware-iot/smart-lock-event-monitors.md) — Monitors state changes and attributes for smart locks, including specific lock actions and door status. ([source](https://github.com/AlexxIT/XiaomiGateway3/wiki/Handle-BLE-Locks))
- [Hardware Compatibility Layers](https://awesome-repositories.com/f/hardware-iot/usb-device-communication/usb-device-stack-implementations/hardware-compatibility-layers.md) — Adds support for unsupported device models by implementing external data converters and mapping raw hardware signals.

### Business & Productivity Software

- [BLE and Matter Device Interfacing](https://awesome-repositories.com/f/business-productivity-software/home-automation-integrations/home-automation-controller-integrations/ble-and-matter-device-interfacing.md) — Interfaces with Bluetooth Low Energy and Matter standard hardware including locks, lighting, and presence sensors.
- [Matter Standard Integrations](https://awesome-repositories.com/f/business-productivity-software/home-automation-integrations/home-automation-controller-integrations/matter-standard-integrations.md) — Connects and controls lighting and plug devices that follow the Matter connectivity standard. ([source](https://github.com/AlexxIT/XiaomiGateway3/blob/master/DEVICES.md))

### Networking & Communication

- [Local Hardware Gateway Communication](https://awesome-repositories.com/f/networking-communication/local-hardware-gateway-communication.md) — Establishes direct socket connections to hardware hubs to bypass cloud reliance and reduce command latency.
- [Local Device Token Retrievals](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-services/notification-delivery-services/push-notification-providers/device-token-management/local-device-token-retrievals.md) — Includes utilities for extracting authentication tokens and keys from smart home devices for direct local control. ([source](https://github.com/AlexxIT/XiaomiGateway3#readme))

### Web Development

- [Zigbee Bridges](https://awesome-repositories.com/f/web-development/api-bridges/zigbee-bridges.md) — Exposes hardware chips to external controllers by mapping Zigbee sensors and lights to unified network endpoints. ([source](https://github.com/AlexxIT/XiaomiGateway3/blob/master/README.md))
- [Hardware Compatibility Plugins](https://awesome-repositories.com/f/web-development/extension-support/plugin-based-device-support/hardware-compatibility-plugins.md) — Implements external data converters to extend hardware compatibility for specific device models. ([source](https://github.com/AlexxIT/XiaomiGateway3#readme))

### Data & Databases

- [Hardware Entity Mappings](https://awesome-repositories.com/f/data-databases/entity-relationships/hardware-entity-mappings.md) — Translates raw hardware data into logical platform entities using external configuration files to support new device models.

### Security & Cryptography

- [Authentication Token Extraction](https://awesome-repositories.com/f/security-cryptography/token-based-authentication/authentication-token-extraction.md) — Extracts security keys and tokens from account data to authenticate requests against locked hardware APIs.

### Part of an Awesome List

- [Vendor Integrations](https://awesome-repositories.com/f/awesome-lists/devtools/vendor-integrations.md) — Local control for Xiaomi and Aqara gateways.