{"id":46573822,"url":"https://github.com/cyborg2017/midea_smart_home","last_synced_at":"2026-06-07T12:03:53.920Z","repository":{"id":340302949,"uuid":"1162592776","full_name":"Cyborg2017/midea_smart_home","owner":"Cyborg2017","description":"Midea Smart device integration with local network control from Home Assistant","archived":false,"fork":false,"pushed_at":"2026-05-17T04:44:29.000Z","size":1562,"stargazers_count":64,"open_issues_count":0,"forks_count":20,"subscribers_count":0,"default_branch":"staging","last_synced_at":"2026-05-17T06:49:20.817Z","etag":null,"topics":["custom-integration","hacs-integration","home-assistant","homeassistant","midea"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cyborg2017.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-20T13:05:18.000Z","updated_at":"2026-05-17T04:44:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Cyborg2017/midea_smart_home","commit_stats":null,"previous_names":["cyborg2017/midea_smart_home"],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/Cyborg2017/midea_smart_home","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyborg2017%2Fmidea_smart_home","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyborg2017%2Fmidea_smart_home/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyborg2017%2Fmidea_smart_home/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyborg2017%2Fmidea_smart_home/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cyborg2017","download_url":"https://codeload.github.com/Cyborg2017/midea_smart_home/tar.gz/refs/heads/staging","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyborg2017%2Fmidea_smart_home/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33389229,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T04:15:53.637Z","status":"ssl_error","status_checked_at":"2026-05-23T04:15:53.242Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["custom-integration","hacs-integration","home-assistant","homeassistant","midea"],"created_at":"2026-03-07T09:20:08.192Z","updated_at":"2026-06-07T12:03:53.900Z","avatar_url":"https://github.com/Cyborg2017.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Midea Smart Home\n\nEnglish | [简体中文](README_hans.md)\n\n[![GitHub Release][releases-shield]][releases]\n[![GitHub Activity][commits-shield]][commits]\n[![License][license-shield]](LICENSE)\n[![hacs][hacsbadge]][hacs]\n\nHome Assistant custom integration for Midea smart devices via local network.\n\n## Features\n\n- **Local Control**: Devices are controlled directly via local network, no cloud connection required\n- **Multi-Cloud Platform Support**: Support Midea MSmart Home, Midea Air, NetHome Plus, Ariston Clima and more cloud platforms\n- **Auto Protocol Download**: Automatically download Lua protocol scripts from cloud (first-time setup only)\n- **Flexible Configuration**: Support customizing entity attributes through device mapping files, easy to adapt new devices\n- **Multi-language Support**: Support Chinese and English interface\n- **Rich Entity Platforms**: Support climate, sensor, switch, select, button, number, vacuum, binary_sensor, fan, humidifier, light, cover, water_heater\n- **Device Status Notifications**: Display device online/offline status notifications in Home Assistant sidebar\n\n## Workflow\n\n**Configuration Phase**\n1. User enters account credentials (supports multiple cloud platforms)\n2. Select the appropriate cloud server based on your app and region\n3. Login to Cloud API\n\n![Setup](docs/images/en/1.png)\n\n**Discovery Phase**\n1. Get device details from cloud (Device ID, Model, SN8, etc.)\n2. Auto-download Lua protocol file for the device\n3. Scan device IP address in local network\n4. Get device Token and Key for V3 protocol devices (not required for V1/V2)\n\n**Runtime Phase**\n1. Connect to device via local network\n2. Parse device protocol using Lua script\n3. Most devices receive status updates via callback push; special devices (e.g. 0xD9 Twin Tub Washer) use periodic polling\n4. User commands sent directly to device (no cloud needed)\n\n## Requirements\n\n- **Home Assistant** \u003e= 2025.12.4\n\n## Installation\n\n### One-Click Install (Recommended)\n\n[![Open your Home Assistant instance and add this HACS repository.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=Cyborg2017\u0026repository=midea_smart_home\u0026category=integration)\n\n### HACS (Custom Repository)\n\n1. Open HACS in Home Assistant\n2. Go to \"Integrations\"\n3. Click the \"+\" button (top right)\n4. Click \"⚙️ Custom repositories\" (3 dots menu \u003e Custom repositories)\n5. Enter: `https://github.com/Cyborg2017/midea_smart_home`\n6. Category: **Integration**\n7. Click \"Add\"\n8. Search for \"Midea Smart Home\" and click \"Download\"\n\n### Manual Installation\n\n1. Copy the `custom_components/midea_smart_home` directory to your Home Assistant `custom_components` folder\n2. Restart Home Assistant\n3. Go to Settings \u003e Devices \u0026 Services\n4. Click \"Add Integration\"\n5. Search for \"Midea Smart Home\"\n\n## Configuration\n\nFor detailed configuration guide, please see [Configuration Guide](GUIDE.md)\n\n## Supported Devices\n\n| No. | Code | Device Type |\n|-----|------|-------------|\n| 1 | 0x13 | Smart Light |\n| 2 | 0x17 | Drying Rack |\n| 3 | 0x26 | Bath Heater |\n| 4 | 0x9C | Integrated Stove |\n| 5 | 0xA1 | Dehumidifier |\n| 6 | 0xAC | Floor Air Conditioner / Wall Air Conditioner / Central Air Conditioner / Central Fresh Air / Central Miniaturized Fresh Air |\n| 7 | 0xB0 | Microwave Oven |\n| 8 | 0xB6 | Range Hood |\n| 9 | 0xB8 | Smart Robot Vacuum |\n| 10 | 0xBF | Microwave Steam Oven |\n| 11 | 0xC2 | Smart Toilet |\n| 12 | 0xCA | Multi-Door Fridge |\n| 13 | 0xCC | WiFi Remote Control Device (Central Air Conditioner) |\n| 14 | 0xD9 | Twin Tub Washing Machine |\n| 15 | 0xDA | Top Load Washing Machine |\n| 16 | 0xDB | Cylinder Washing Machine |\n| 17 | 0xDC | Clothes Dryer |\n| 18 | 0xE1 | Dishwasher |\n| 19 | 0xE2 | Electric Water Heater |\n| 20 | 0xE3 | Gas Water Heater |\n| 21 | 0xE6 | Gas Wall Hanging Stove |\n| 22 | 0xEA | Rice Cooker |\n| 23 | 0xED | Net Drinking Machine / Water Purifier / Pipeline Machine |\n| 24 | 0xFA | Electric Fan |\n| 25 | 0xFB | Electric Heater |\n| 26 | 0xFC | Air Purifier |\n| 27 | 0xFD | Humidifier |\n\n\u003e More device types are being adapted. Contributions are welcome!\n\n## Credits\n\nThis project uses/references some code from:\n- [midea_auto_cloud](https://github.com/sususweet/midea_auto_cloud)\n- [midea_ac_lan](https://github.com/wuwentao/midea_ac_lan)\n- [midea-local](https://github.com/midea-lan/midea-local)\n\n[commits-shield]: https://img.shields.io/github/commit-activity/y/Cyborg2017/midea_smart_home.svg?style=for-the-badge\n[commits]: https://github.com/Cyborg2017/midea_smart_home/commits/main\n[hacs]: https://github.com/hacs/integration\n[hacsbadge]: https://img.shields.io/badge/HACS-Custom-orange.svg?style=for-the-badge\n[license-shield]: https://img.shields.io/github/license/Cyborg2017/midea_smart_home.svg?style=for-the-badge\n[releases-shield]: https://img.shields.io/github/release/Cyborg2017/midea_smart_home.svg?style=for-the-badge\n[releases]: https://github.com/Cyborg2017/midea_smart_home/releases\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyborg2017%2Fmidea_smart_home","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcyborg2017%2Fmidea_smart_home","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyborg2017%2Fmidea_smart_home/lists"}