Installation

Magic Areas can be installed manually or through HACS.

HACS

Go to HACS > Integrations > Click the + button > Search magic areas > Click on it > Click Add Repository.

Manual mode

Copy custom_components/magic_areas folder into your Home Assistant's custom_component folder.

In both cases / Activating Magic Areas

Include the following into your configuration.yaml file (or in a package):

magic_areas:

Nothing else is needed on your configuration.yaml file. Everything else will be configured using the Integrations UI on Home Assistant. Using YAML configuration is not supported (although it should work) and discouraged.

Restart Home Assistant and Magic Areas shall show up in the Integrations page and if you have existing areas from Home Assistant's Area Registry, you should have binary_sensor.area_{area-name} already created. In case they don't show up, you either don't have areas configured or might need to check your logs.

Debugging your installation

Please enable debug logging by putting this in configuration.yaml:

logger:
    default: warning
    logs:
        custom_components.magic_areas: debug

What's next?

After you verified that your installation works, proceed to our Getting Started doc!