git404hub

what is midea-ac-py fr?

cjay42/midea-ac-py — explained in plain English

Analysis updated 2026-05-18

11PythonAudience · generalComplexity · 2/5Setup · moderate

tl;dr

A Home Assistant integration for controlling Midea-made air conditioners, sold under dozens of brand names, over the local network without needing the cloud.

vibe map

mindmap
  root((midea-ac-py))
    What it does
      Local AC control
      Auto device discovery
      Feature detection
    Tech stack
      Python
      Home Assistant
      HACS
    Use cases
      Control AC locally
      Automate presets
      Monitor energy use
    Audience
      Smart home users
      Midea AC owners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Control a Midea-made air conditioner, sold under any of dozens of brand names, from Home Assistant.

VIBE 2

Automate AC presets like eco, sleep, or boost mode based on other Home Assistant triggers.

VIBE 3

Monitor energy and power usage sensors exposed by a supported air conditioner.

VIBE 4

Set up a device manually with its token and key instead of using Midea's cloud discovery.

what's the stack?

PythonHome AssistantHACS

how it stacks up fr

cjay42/midea-ac-py2arons/llm-cliabe238/claude-video-plus
Stars111111
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity2/52/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Newer V3 devices need a one-time cloud connection during setup to fetch a token and key.

in plain english

This is a Home Assistant integration that lets you control Midea air conditioners, and the many other brands Midea manufactures under license, directly over your local network rather than through the internet. Midea makes air conditioning units sold under dozens of other names, including Carrier, Samsung, Toshiba, LG, Comfee, and many more, so a device sold under a completely different brand may still work here if it uses one of a handful of specific companion apps. Only air conditioner type devices are supported, not other kinds of Midea appliances. Control happens locally, so no ongoing internet connection is needed once a device is set up. The one exception is newer devices, referred to as V3 devices, which need to reach Midea's cloud service once, during initial discovery, to obtain a security token and key. After that first setup, the saved token and key are enough, and no further cloud connection is required. Anyone uncomfortable with that step can instead get the token and key themselves using a separate command line tool and their own account. Once connected, the integration automatically figures out which features a given device actually supports and only shows those in Home Assistant, rather than presenting options that would not work. Depending on the device, this can include sleep, eco, boost, and away presets, control of the unit's display, error codes reported as an attribute, energy and power usage sensors, an air purifier toggle, filter alerts, custom fan speeds, humidity sensors and targets, swing angle control, and various other manufacturer specific modes. The project has been translated into more than twenty languages by contributors. Installation is normally done through HACS, a Home Assistant add-on manager, by searching for Midea Smart AC, though it can also be installed manually by copying the integration's folder into Home Assistant's custom components directory and restarting. Setup then happens through the graphical interface, either by letting Home Assistant automatically discover devices on the network or by entering a device's ID, IP address, and, for V3 devices, its token and key by hand. A number of extra options exist per device to fine tune behavior, such as reversing swing direction, adjusting temperature step size, and limiting how long a network connection stays open before reconnecting.

prompts (copy fr)

prompt 1
Help me install this integration via HACS and discover my Midea air conditioner.
prompt 2
Explain the difference between automatic and manual device configuration for V3 devices.
prompt 3
What features does this integration expose for my specific AC brand?
prompt 4
How do I get the device token and key manually instead of using Midea's cloud?

Frequently asked questions

what is midea-ac-py fr?

A Home Assistant integration for controlling Midea-made air conditioners, sold under dozens of brand names, over the local network without needing the cloud.

What language is midea-ac-py written in?

Mainly Python. The stack also includes Python, Home Assistant, HACS.

How hard is midea-ac-py to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is midea-ac-py for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.