Homepage: https://github.com/purplg/hass
Author: Ben Whitley
Updated:
Interact with Home Assistant
This mode enables interaction with a Home Assistant instance from within Emacs.
--------------------
Configuration
Both `hass-host' and `hass-apikey' must be set to use this package.
(setq hass-host "192.168.1.10") ; Required
(setq hass-insecure t) ; If using HTTP and not HTTPS
(setq hass-port 8123) ; If using a different port other than the default 8123
(setq hass-apikey "APIKEY-GOES-IN-HERE") ; Required. See below.
(hass-setup)
Getting an API Key:
Ensure that your Home Assistant instance is configured to support API calls by following the
instructions here: `https://www.home-assistant.io/integrations/api/'.
Retrieve your API key a.k.a. /Long-Lived Access Token/ by logging into your Home Assistant
instance and going to your profile by selecting your username in the lower-left corner or going
to this URL: `http://HOME-ASSISTANT-URL:8123/profile'. You can generate an API token at the very
bottom of this page.
--------------------
Usage
Use `hass-call-service' to make service calls on the configured Home Assistant instance:
(hass-call-service "switch.bedroom_light" "switch.toggle")
Or use `hass-call-service-with-payload' to customize the payload:
(hass-call-service-with-payload
"mqtt.publish"
(json-encode '(("payload" . "PERFORM")
("topic" . "valetudo/vacuum/LocateCapability/locate/set"))))
See README.org for more information.