{"id":24915530,"url":"https://github.com/hasscc/meiju","last_synced_at":"2025-06-30T05:03:42.768Z","repository":{"id":41188212,"uuid":"508670619","full_name":"hasscc/meiju","owner":"hasscc","description":"Midea Meiju (美的美居) For HomeAssistant","archived":false,"fork":false,"pushed_at":"2023-08-14T13:25:27.000Z","size":305,"stargazers_count":82,"open_issues_count":7,"forks_count":7,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-04-09T14:09:14.257Z","etag":null,"topics":["custom-component","home-assistant","iot","meiju","midea"],"latest_commit_sha":null,"homepage":"","language":"Lua","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/hasscc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-06-29T11:52:16.000Z","updated_at":"2025-03-14T03:38:36.000Z","dependencies_parsed_at":"2022-07-14T10:21:37.017Z","dependency_job_id":null,"html_url":"https://github.com/hasscc/meiju","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hasscc/meiju","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasscc%2Fmeiju","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasscc%2Fmeiju/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasscc%2Fmeiju/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasscc%2Fmeiju/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hasscc","download_url":"https://codeload.github.com/hasscc/meiju/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasscc%2Fmeiju/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262714471,"owners_count":23352462,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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-component","home-assistant","iot","meiju","midea"],"created_at":"2025-02-02T07:18:00.873Z","updated_at":"2025-06-30T05:03:42.745Z","avatar_url":"https://github.com/hasscc.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Midea Meiju for HomeAssistant\n\n## Installing\n\n\u003e [Download](https://github.com/hasscc/meiju/archive/main.zip) and copy `custom_components/meiju` folder to `custom_components` folder in your HomeAssistant config folder\n\n```shell\n# Auto install via terminal shell\nwget -q -O - https://cdn.jsdelivr.net/gh/hasscc/get/get | HUB_DOMAIN=ghproxy.com/github.com DOMAIN=meiju REPO_PATH=hasscc/meiju ARCHIVE_TAG=main bash -\n```\n\n\n## Config\n\n```yaml\n# configuration.yaml\n\nmeiju:\n  # Single account\n  username: 18866668888 # Username of Meiju APP (美的美居)\n  password: abcdefghijk # Password\n  devices:\n    - device_id: 160123456789001\n      host: 192.168.1.101\n    - device_id: 160123456789002\n      host: 192.168.1.102\n\n  # Multiple accounts\n  accounts:\n    - username: 18866668881\n      password: password1\n      devices:\n        - device_id: 160123456789003\n          host: 192.168.1.123\n    - username: 18866668882\n      password: password2\n      scan_interval: 00:00:20\n      devices:\n        - device_id: 160123456789004\n          host: 192.168.1.234\n          scan_interval: 00:00:15\n\n  # https://github.com/hasscc/meiju/blob/main/custom_components/meiju/device_customizes.yaml\n  customizes:\n    B3: # Device type or sn8\n      get_extra: {10: 0x31}\n      set_extra: {10: 0x21}\n      sensors:\n        status:\n          byte: 11\n          dict: [power_off, power_on, working]\n          attrs_template: |-\n            {{ {\n              'preheat': bytes[26]|bitwise_and(0x02) \u003e 0,\n              'cooling': bytes[26]|bitwise_and(0x08) \u003e 0,\n            } }}\n      binary_sensors:\n        upstair_door:\n          byte: 21\n          state_template: '{{ value|bitwise_and(0x04) \u003e 0 }}'\n      switches:\n        power:\n          byte: 11\n          on_extra: {16: 0x01, 22: 0x01}\n          off_extra: {16: 0x00, 22: 0x00}\n        lock:\n          byte: 21\n          on_value: 0x01\n          off_value: 0x00\n      selects:\n        mode:\n          byte: 12\n          options:\n            0: {name: 空闲, extra: {11: 0x00}}\n            23: {name: 保洁(75分钟75℃), extra: {13: 75, 14: 15, 27: 60}}\n            26: {name: 长效存储(15分钟60℃), extra: {13: 60, 14: 15, 27: 0}}\n          set_extra: {11: 0x02}\n      numbers:\n        upstair_temp:\n          byte: 13\n          step: 5\n          min: 60\n          max: 125\n```\n\n\n## Services\n\n#### Get Meiju Devices\n```yaml\nservice: meiju.get_devices\ndata:\n  username: 18866668881\n  throw: true # Show result in HA notifications\n```\n\n#### Request Meiju API\n```yaml\nservice: meiju.request_api\ndata:\n  entity_id: sensor.xac_xxxxxx_info # Any sensor entity in the account\n  username: 18866668881 # Optional if entity_id is specified\n  api: /appliance/home/list/get\n  params:\n    homegroupId: 666666\n```\n\n#### Send control command to device\n```yaml\nservice: meiju.send_command\ndata:\n  entity_id: sensor.xac_xxxxxx_info\n  command: AA BB CC # Command bytes like: FF 00 AA\n                    # [0xAA, 0xFF, 0x00]\n                    # {11: 0xAA, 13: 0xBB}\n```\n\n#### Get Meiju device Lua script\n```yaml\nservice: meiju.get_lua\ndata:\n  entity_id: sensor.xac_xxxxxx_info\n```\n\n#### Get Meiju device plugin\n```yaml\nservice: meiju.get_plugin\ndata:\n  entity_id: sensor.xac_xxxxxx_info\n```\n\n\n## Thanks\n- https://github.com/mac-zhou/midea-msmart\n- [@vividmuse](https://github.com/vividmuse)\n- [@blindlight86](https://github.com/blindlight86)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhasscc%2Fmeiju","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhasscc%2Fmeiju","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhasscc%2Fmeiju/lists"}