Go to file
Otto Winter 4046a16d85
Merge branch 'dev' into rc
2019-01-06 19:38:23 +01:00
.github Merge branch 'dev' into rc 2019-01-06 19:38:23 +01:00
docker Merge branch 'dev' into rc 2019-01-06 19:38:23 +01:00
esphomeyaml Merge branch 'dev' into rc 2019-01-06 19:38:23 +01:00
esphomeyaml-beta Merge branch 'dev' into rc 2019-01-06 19:38:23 +01:00
esphomeyaml-edge Merge branch 'dev' into rc 2019-01-06 19:38:23 +01:00
tests Merge branch 'dev' into rc 2019-01-06 19:38:23 +01:00
.dockerignore Fix docker build 2018-09-25 10:30:45 +02:00
.gitignore Merge branch 'dev' into rc 2019-01-06 19:38:23 +01:00
.gitlab-ci.yml Merge branch 'dev' into rc 2019-01-06 19:38:23 +01:00
.travis.yml Merge branch 'dev' into rc 2019-01-06 19:38:23 +01:00
CODE_OF_CONDUCT.md Add Code of Conduct (Contributor Covenant) (#168) 2018-10-12 11:26:26 +02:00
CONTRIBUTING.md Create CONTRIBUTING.md (#169) 2018-10-12 11:26:05 +02:00
Dockerfile Merge branch 'dev' into rc 2019-01-06 19:38:23 +01:00
LICENSE Create LICENSE 2018-07-28 16:33:01 +02:00
MANIFEST.in Merge branch 'dev' into rc 2019-01-06 19:38:23 +01:00
README.md Fix readme broken link (#174) 2018-10-12 12:05:48 +02:00
pylintrc Merge branch 'dev' into rc 2019-01-06 19:38:23 +01:00
repository.json Merge branch 'dev' into rc 2019-01-06 19:38:23 +01:00
requirements.txt Merge branch 'dev' into rc 2019-01-06 19:38:23 +01:00
setup.cfg Merge branch 'dev' into rc 2019-01-06 19:38:23 +01:00
setup.py Merge branch 'dev' into rc 2019-01-06 19:38:23 +01:00

README.md

esphomeyaml for esphomelib

Getting Started Guide: https://esphomelib.com/esphomeyaml/guides/getting_started_command_line.html

Available Components: https://esphomelib.com/esphomeyaml/index.html

esphomeyaml is the solution for your ESP8266/ESP32 projects with Home Assistant. It allows you to create custom firmwares for your microcontrollers with no programming experience required. All you need to know is the YAML configuration format which is also used by Home Assistant.

esphomeyaml will:

  • Read your configuration file and warn you about potential errors (like using the invalid pins.)
  • Create a custom C++ sketch file for you using esphomeyaml's powerful C++ generation engine.
  • Compile the sketch file for you using platformio.
  • Upload the binary to your ESP via Over the Air updates.
  • Automatically start remote logs via MQTT.

And all of that with a single command 🎉:

esphomeyaml configuration.yaml run

Features

  • No programming experience required: just edit YAML configuration files like you're used to with Home Assistant.
  • Flexible: Use esphomelib's powerful core to create custom sensors/outputs.
  • Fast and efficient: Written in C++ and keeps memory consumption to a minimum.
  • Made for Home Assistant: Almost all Home Assistant features are supported out of the box. Including RGB lights and many more.
  • Easy reproducible configuration: No need to go through a long setup process for every single node. Just copy a configuration file and run a single command.
  • Smart Over The Air Updates: esphomeyaml has OTA updates deeply integrated into the system. It even automatically enters a recovery mode if a boot loop is detected.
  • Powerful logging engine: View colorful logs and debug issues remotely.
  • Open Source
  • For me: Makes documenting esphomelib's features a lot easier.

Special Thanks

Special Thanks to the Home Assistant project. Lots of the code base of esphomeyaml is based off of Home Assistant, for example the loading and config validation code.