Star on GitHubStar2.4k stars

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

Copy as MarkdownView JSONCite

Evidence

Demo screenshot from the project's public documentation
Observed
Download and demo observed; the case covers part of the target software.
Scope
Partial
Checked
2026-11-08

How evidence classes are assigned

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.

Report an outdated entry Suggest a translation fix

Primary sources

  1. README.md GitHub · AdeelGameDev/LocalAC · Revision 7b3910e

More in Protocols

All 720 entries in ProtocolsProtocols case studies (645)

↑↓ move↵ open⌘↵ new tab