Free, hands-on classes by Brandon Harvey (SmartHomeSellout), first taught at the Dallas Makerspace. Read them online, download print versions, or fork this repo and teach your own.
Read online: classes.smarthomesellout.com
| Class | Status | Materials |
|---|---|---|
| Intro to Home Assistant | Live | Speaker outline · Attendee handout |
| ESPHome | Planned | |
| Low-Voltage LED Lighting with WLED | Planned | |
| Soldering | Planned |
Every class has a rolling release with its current docx and PDF builds, refreshed automatically on every change. For Intro to Home Assistant: the intro-ha release.
Each class is a folder of plain Markdown under docs/. Two GitHub Actions workflows run on every push to main:
- Website (
.github/workflows/pages.yml): builds the Markdown into an MkDocs Material site and deploys it to GitHub Pages. - Documents (
.github/workflows/build.yml): converts each class's outline and handout to docx (via pandoc) and PDF (via LibreOffice), then refreshes that class's rolling release.
# Website
python3 -m venv .venv
.venv/bin/pip install "mkdocs-material==9.*" mkdocs-redirects
.venv/bin/mkdocs serve # preview at http://127.0.0.1:8000
# Documents (needs pandoc and libreoffice)
pandoc docs/intro-to-home-assistant/outline.md -o Intro-to-HA-Speaker-Outline.docx
soffice --headless --convert-to pdf Intro-to-HA-Speaker-Outline.docx- Fork this repo.
- Edit a class's Markdown (or copy a class folder to start a new one), swapping in your own gear, stories, and demos.
- Push, and the site and documents rebuild for you.
One rule: outline and handout files stay plain Markdown (no HTML, no theme-specific syntax) because the same files feed the docx/PDF builds.
Content is licensed under Creative Commons Attribution 4.0 (CC BY 4.0): use it, remix it, teach with it. Just keep an attribution back to this project.