Scenegen is a scene generation tool for Home Assistant home automation software. It creates scenes by example, by reading the current states of devices and outputting a corresponding scene. Scenegen is written in python using Home Assistant's RESTFul API so can be run from anywhere. It currently supports lights and switches only.
To set up SceneGen and install it locally, run the following from a shell in the checkout:
$ make
Then the script can be run locally from the checkout:
$ ./bin/scenegen --help
See the Home Assistant documentation for full usage instructions and documentation.
Use the $ make export
target to aid in exporting multiple scenes to YAML on
the filesystem. This can be useful for "exporting" scenes from an
integration, such as SmartThings, to native Home Assistant themes:
$ make EXPORT_ALL_SCENES=true URL=https://home-assistant.example.com:8123 TOKEN=... EXPORT_SCENE_DIR=../path/to/scenes export
If you don't want to export all the scenes, you can create a .scenes
file in
the EXPORT_SCENE_DIR
listing one scene per line to export and remove the
EXPORT_ALL_SCENES
option.
Beyond these options, the export*
targets in Makefile
can be used as a
reference or starting point to automate exporting multiple scenes.