Installing to Home Assistant

Home Assistant Usage

For now the installation is done manually in your configuration directory. This guide expects a basic understanding of Home Assistant and its configuration.

You'll need to follow these steps in order to use this platform (All paths are relative to Home Assistant's configuration directory):

• Create a directory ./custom_components/climate if it doesn't exist
• Add the following configuration to your Home Assistant's configuration.yaml changing the username field:

climate:
  - platform: midea
    app_key: 3742e9e5842d4ad59c2db887e12449f9
    username: '[email protected]'
    password: !secret midea_password

• Add the following to your Home Assistant's secrets.yaml changing the placeholder with your actual password:

midea_password: PLACEHOLDER

• Copy midea.py from the repository into ./custom_components/climate

Once that is done, you need to install the Midea library as a dependency. Home Assistant has issues installing dependencies from custom components on its own. You'll need to pick one of these methods to install the dependencies.

Install using the Custom Component Updater

This is by far the most reliable, and supports automatic updating of the component and the library. You'll need to install this component separately, and instructions to do so can be found here: https://github.com/custom-components/custom_updater

You'll need to add the following to your configuration.yaml

custom_updater:
  track:
    - components
  component_urls:
    - https://raw.githubusercontent.com/NeoAcheron/midea-ac-py/master/custom_components.json

Once Home Assistant has been restarted, the component and its dependencies can be installed using the custom_updater.install service. To update the component at a later stage, you can call the custom_updater.check_all service to check for updates, and then the custom_updater.update_all service to update.

This will track the component and its dependencies for new releases and can be updated by calling a service directly from Home Assistant.

Install using Pip

This will install the latest release version of hte library to the dependency directory. pip install midea -t ./deps/lib/python3.6/site-packages/

Install manually

Not recommended, but its useful if you want to run the latest unreleased version.

• Copy the entire midea directory from the repository to ./deps/lib/python3.6/site-packages/midea