Home Assistant - Albert Python Extension

An Albert extention to view and control devices in your HomeAssistant instance.

This extension is heavily inspired by the home assistant extesnsion for ulauncher from qcasey.

Requirements

To use this extension, you need the Python requests library:

pip install requests

Configuration

You need to specify the URL and API Key of your Home Assistant instance in the configuration file (e.g. location: $HOME/.config/albert/homeassistant_config.json). You can generate a new long lived API Key by clicking your name in the bottom left in the Home Assistant UI.

Example:

{
    "hass_url": "http://192.168.1.2:8123",
    "hass_key": "s1GeOobviEbg019H32dTs973GU2sJ3zBIMETxKSLCzoJulgljXB31m1aqq2GFWe2TsaLRxYo0J08FHxEdXxzSzNJMNZS3OjfkYVmOQDMbCRIH0kCtisGVi2EQoKbDeqq"
}

The item order is based on the entity class. Lights and switches are shown first, then scenes and groups etc. You can change the order in the configuration file with sort_order. See the default sorting order below:

{   ...
    sort_order: {"light": 1, "switch": 1, "scene": 2, "group": 2, "automation": 3}
}

Usage

<trigger> <entity search>

You can see the actions by pressing the alt key.

ToDo

renew icons (.svg)
test more device classes and adjust which service to call

Contributing

I welcome all issues and contributions! You can send patches per email to dev-at-hoellen.eu or open a PR/issue.

1.7 KiB Raw Blame History