https://github.com/mawalu/homeassistant-cli

cli home-assistant home-automation nodejs

Last synced: about 1 year ago
JSON representation

Control your smart home from the terminal

README

# homeassistant-cli

A simple cli tool for [Home Assistant](https://home-assistant.io/) that uses [node-homeassistant](https://github.com/Mawalu/node-homeassistant).

## Installation

```shell
$ npm install -g homeassistant-cli
```

If there is an permission error you have to reconfigure npm or use sudo

## Usage

Call a service

```shell
$ hac call light turn_on
```

Add additional service data

```shell
$ hac call light turn_on --service-data '{"entity_id": "light.komode"}'
```

Query the state

```shell
$ hac state sun.sun
```

Subscribe to state changes

```shell
$ hac state -s sun.sun
```

## Additional parameters

Custom hostname, port and password

```shell
$ hac --ip 10.1.0.166 --port 80 --api-password "hunter4" state sun.sun
```

To find shorthands and some extra parameters use

```shell
$ hac --help
```

## Scripting example

You can use this to access Home Assistant from your scripts

```bash
#!/bin/bash

hac state -s light.komode | while read -r change; do
state=$(echo "$change" | jq ".new_state.state")

echo "Light is now $state"
done
```