OttoScript is domain specific language (DSL) designed to make writing HomeAssistant automations easier, and more intuitive than existing options, while being powerful enough to handle all but the most complex situations.
OttoPyScript is the interpreter layer that converts OttoScript commands into HomeAssitant commands (via the PyScript integration). You need both if you want to try OttoScript on HomeAssistant. (A simpler install process will be available before 1.0 release).
- Install Pyscript by either HACS (preferred) or manual method. Be sure to set
allow_all_imports: truein your pyscript configuration. - Install ottoscript in the
/config/directory of your HA instance. You can download the latest or git clone on the master branch, but make sure the entirety of the repo is in /config/ottoscript/ - Clone this repository into
/config/pyscript/apps/or download the latest release and copy the files to the same location. (If this directory doesn't exist, you probably didn't reboot after install pyscript).
The OttoPyScript config (see config.yaml.sample) needs to be place included or copied directly into the Apps: section of the pyscript config (/config/pyscript/config.yaml).
Options: Directory - the path to your scripts directory in your HA instance (pick any place you like). OttoScript will run all files ending in .otto in that directory. (It will NOT check subdirectories).
Verbose: 0 or 1. Controls the amount of debugging info writing to the HA log. Leave this on 0 unless you're seeing an error you can't otherwise explain.
area_shortcuts: a dictionary of lists. The keys are 'groups' and the items are HomeAssistant areas (or other groups). Best understood by looking at the sample file. These groups can be referenced like any other area in OttoScript.
See the ottoscript repository for details on the language and writing automations.