{"id":15662142,"url":"https://github.com/ollo69/ha-melcloud-custom","last_synced_at":"2025-04-14T13:10:38.367Z","repository":{"id":39658501,"uuid":"245500369","full_name":"ollo69/ha-melcloud-custom","owner":"ollo69","description":"Home Assistant custom integration for MelCloud AC devices with additional Swing control and WI-Fi Sensor","archived":false,"fork":false,"pushed_at":"2024-05-28T05:53:38.000Z","size":128,"stargazers_count":21,"open_issues_count":10,"forks_count":9,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-28T02:13:41.931Z","etag":null,"topics":["airconditioners","climate","home-assistant","homeassistant","melcloud","mitsubishi","sensors","thermostat"],"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/ollo69.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-06T19:26:28.000Z","updated_at":"2024-06-08T11:23:50.000Z","dependencies_parsed_at":"2023-01-30T02:15:41.174Z","dependency_job_id":"2b29a741-5042-4778-9ebb-3a7cb0efa60a","html_url":"https://github.com/ollo69/ha-melcloud-custom","commit_stats":{"total_commits":84,"total_committers":4,"mean_commits":21.0,"dds":"0.41666666666666663","last_synced_commit":"c8610f2c9ffdfca85875f2b070ae5186ebde7fac"},"previous_names":[],"tags_count":34,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ollo69%2Fha-melcloud-custom","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ollo69%2Fha-melcloud-custom/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ollo69%2Fha-melcloud-custom/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ollo69%2Fha-melcloud-custom/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ollo69","download_url":"https://codeload.github.com/ollo69/ha-melcloud-custom/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248886327,"owners_count":21177643,"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":["airconditioners","climate","home-assistant","homeassistant","melcloud","mitsubishi","sensors","thermostat"],"created_at":"2024-10-03T13:30:18.455Z","updated_at":"2025-04-14T13:10:37.727Z","avatar_url":"https://github.com/ollo69.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![](https://img.shields.io/github/release/ollo69/ha-melcloud-custom/all.svg?style=for-the-badge)](https://github.com/ollo69/ha-melcloud-custom/releases)\n[![hacs_badge](https://img.shields.io/badge/HACS-Custom-orange.svg?style=for-the-badge)](https://github.com/hacs/integration)\n[![](https://img.shields.io/github/license/ollo69/ha-melcloud-custom?style=for-the-badge)](LICENSE)\n[![](https://img.shields.io/badge/MAINTAINER-%40ollo69-red?style=for-the-badge)](https://github.com/ollo69)\n[![](https://img.shields.io/badge/COMMUNITY-FORUM-success?style=for-the-badge)](https://community.home-assistant.io)\n\n# MELCloud HomeAssistant custom component\n\n## ℹ️ Note\nDue to the latest restrictions introduced by MELCloud platform (see [here](https://github.com/ollo69/ha-melcloud-custom/issues/13)) I decided to implement the control of my AC devices through the adoption of small and economical `ESP8266` devices connected to `CN105` units connector which allow real-time control via MQTT (see [here](https://github.com/dzungpv/mitsubishi2MQTT) an example).\n\nAs consequence I no longer have a way to maintain this integration, fixing bug, implementing new features and adapting to HA architecture changes.\n\nIf anyone is interested in taking charge of it, they can possibly fork this repository and I will report the new reference link here in the notes.\n\n**This repository will be shortly moved in state `archived`.**\n\n## Description\nA full featured Homeassistant custom component to drive MELCloud ATA and ATW devices.\n\nThis custom component is based on the native Home Assistant [MELCloud component](https://github.com/home-assistant/core/tree/dev/homeassistant/components/melcloud) released with version 0.106 and on the same underlying [PyMelCloud library](https://github.com/vilppuvuorinen/pymelcloud).\n\n## Custom component additional features\nI just added some features to the existing native components, waiting for the same features to be implemented:\n\n1. Add support for login language from a list of available options. The language should be the same that you normaly use for other MELCloud application (e.g. your phone app).\n\n1. Added control for **Vertical and Horizontal Swing Modes** on ATA devices using default Swing features.\n\n1. Added sensor to monitor WiFi signal.\n\n1. Added binary sensor to monitor error state.\n\n1. Added some attributes to the sensors to provide additional information (SerialNo, Unit Info, etc)\n\n1. Implemented use of `coordinator` to have update for all entities syncronizes\n\n## Installation \u0026 configuration\nYou can install this component in two ways: via HACS or manually.\n\n### Option A: Installing via HACS\nIf you have HACS, you must add this repository (\"https://github.com/ollo69/ha-melcloud-custom\") to your Custom Repository selecting the Configuration Tab in the HACS page.\nAfter this you can go in the Integration Tab and search the \"MELCloud Custom\" component to install it.\n\n### Option B: Manually installation (custom_component)\n1. Clone the git master branch.\n1. Unzip/copy the melcloud_custom direcotry within the `custom_components` directory of your homeassistant installation.\nThe `custom_components` directory resides within your homeassistant configuration directory.\nUsually, the configuration directory is within your home (`~/.homeassistant/`).\nIn other words, the configuration directory of homeassistant is where the configuration.yaml file is located.\nAfter a correct installation, your configuration directory should look like the following.\n    ```\n    └── ...\n    └── configuration.yaml\n    └── secrects.yaml\n    └── custom_components\n        └── melcloud_custom\n            └── __init__.py\n            └── binary_sensor.py\n            └── climate.py\n            └── ...\n    ```\n\n    **Note**: if the custom_components directory does not exist, you need to create it.\n\n### Component setup\nOnce the component has been installed, you need to configure it in order to make it work.\nThere are two ways of doing so:\n- Using the web interface (Lovelace) [**recommended**]\n- Manually editing the configuration.yaml file\n\n#### Option A: Configuration using the web UI [recommended]\nSimply add a new \"integration\" and look for \"MELCloud Custom\" among the proposed ones. Do not confuse with \"MELCloud\" that is the native one!\n\n#### Option B: Configuration via editing configuration.yaml\nFollow these steps only if the previous configuration method did not work for you.\n\n1. Setup your MELCloud credentials. Edit/create the `secrets.yaml` file,\n which is located within the config directory as well. Add the following:\n\n     ```\n    melcloud_username: my_melcloud_email@domain.com\n    melcloud_password: my_melcloud_password\n    ```\n\n    Where \"my_melcloud_email@domain.com\" is your MELCloud account email and \"my_melcloud_password\" is the associated password.\n\n1. Enable the component by editing the configuration.yaml file (within the config directory as well).\nEdit it by adding the following lines:\n    ```\n    melcloud_custom:\n      username: !secret melcloud_username\n      password: !secret melcloud_password\n      language: my_melcloud_language\n    ```\n\n    Where \"my_melcloud_language\" is your MELCloud account language and can be one of the following (eg: EN):\n\n        EN = English\n        BG = Bulgarian\n        CS = Czech\n        DA = Danish\n        DE = German\n        ET = Estonian\n        ES = Spanish\n        FR = French\n        HY = Armenian\n        LV = Latvian\n        LT = Lithuanian\n        HU = Hungarian\n        NL = Dutch\n        NO = Norwegian\n        PL = Polish\n        PT = Portuguese\n        RU = Russian\n        FI = Finnish\n        SV = Swedish\n        IT = Italian\n        UK = Ukrainian\n        TR = Turkish\n        EL = Greek\n        HR = Croatian\n        RO = Romanian\n        SL = Slovenian\n\n**Note!** In this case you do not need to replace \"!secret melcloud_username\" and \"!secret melcloud_password\".\nThose are place holders that homeassistant automatically replaces by looking at the secrets.yaml file.\n\n1. Reboot home assistant\n1. Congrats! You're all set!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Follo69%2Fha-melcloud-custom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Follo69%2Fha-melcloud-custom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Follo69%2Fha-melcloud-custom/lists"}