Case study
LocalAC: local Gree air-conditioner control from protocol research
LocalAC reconstructs local control of a Gree Pular T3 air conditioner through its LAN protocol. The author documents UDP port 7000 discovery, a bind handshake, AES-GCM command envelopes and property behavior measured on one firmware version. A C# protocol library supports a CLI and .NET MAUI app for status, temperature and other controls.
- Targets
- Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
- Evidence class
- C1 partial scope or analysis entry
- Stars
- 0
- Last commit
- 2026-10-27
- Language
- C#
- License (GitHub)
- MIT
GitHub data as of 2026-11-10
Evidence

- Observed
- Download and demo observed; the case covers part of the target software.
- Scope
- Partial
- Checked
- 2026-11-08
Requirements & limits
- Prerequisites: .NET 10 and a Gree-protocol air conditioner on the same LAN are required.
- Scope: The documented hardware findings concern one Gree Pular T3 unit with firmware U-WB05RT13V1.45.
- Limits: Some reported properties are read-only or ignore writes on that unit.
- License: MIT license.
Cite
BibTeX
@misc{localac-gree-protocol-case,
title = {{LocalAC: local Gree air-conditioner control from protocol research}},
howpublished = {\url{https://github.com/AdeelGameDev/LocalAC}},
url = {https://github.com/AdeelGameDev/LocalAC},
urldate = {2026-11-06},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/localac-gree-protocol-case/}}
}Plain text
LocalAC: local Gree air-conditioner control from protocol research. https://github.com/AdeelGameDev/LocalAC (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/localac-gree-protocol-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
- README.md GitHub · AdeelGameDev/LocalAC · Revision 7b3910e
More in Protocols
- Panoptes: reconstructing Hik-Connect live-stream encryption · Case study
- mchose-linux: reconstructing MCHOSE mouse controls on Linux · Case study
- epson-scan-to-mac: reconstructing Epson panel scanning on Macs · Case study
- OpenMouse: reconstructing Kysona M600 V2 mouse control · Case study
- WDA Konfigurator: a reconstructed Microsoft Wireless Display Adapter configuration client · Case study
- irca-ble-protocol: reconstructing heater control over Bluetooth LE · Case study