About My ESPHome Workshop

Welcome to my personal documentation site where I track my journey turning a collection of dev boards and sensors into (maybe) useful smart home devices.

Why This Site Exists

After 15+ years of accumulating microcontrollers, sensors, and random gadgets, I decided it was time to actually use them. This site serves as my workshop documentation—tracking what I have, what I've built, and what I've learned along the way.

After all these years I realized that it wasn't me going for the new shiny thing, it was just that the world wasn't ready! Now that we have great projects like ESPHome and Home Assistant, it's finally time to take over the ~~world~~ home.

How to Use This Site

🔌 Devices

Browse all the hardware in my collection. Each device includes wiring diagrams, example code, and my personal notes about using it. Well ... that's the plan at least.

🛠️ Projects

Complete project builds with full documentation. Shows what devices were used, the motivation behind the project, and how it turned out.

🧩 Components

ESPHome software components and integrations. These are the building blocks that make the hardware work. Just notes and tying components together.

📓 Notes

General knowledge, setup guides, troubleshooting tips, and lessons learned. The stuff that doesn't fit neatly into device or project docs.

Understanding Device Statuses

Every device has a status that shows how I'm currently using it:

📦 Ready Tested, working, ready to use ... but not used just yet

🧪 Testing Currently experimenting with this on my bench. Updating documentation as I go along.

🔧 Active Being used in an in-progress project - may be deployed once project is complete.

✅ Deployed Actively used in a working project - contains a link to the project where it is used.

🔦 Pending Documentation incomplete, waiting to start testing it. NOTE that documentation might not be fully correct until I finish testing.

🚫 Unsupported Doesn't work with ESPHome - for now 😉

⏸️ Retired Was deployed but no longer in use

The best way to start is by looking into ✅ Completed projects and following the devices used. One thing to note is that even the components used in a project, while they would have been tested and guaranteed are working in this particular project, their documentation might still be incolmplete.

Next best thing is to look into ✅ Deployed, 📦 Ready and 🔧 Active devices. Possibly those in 🧪 Testing state.

Lastly, if you have a device and it's in the list in any state, just go look into it's documentation. There are usually some links to useful information if nothing else.

Understanding Project Statuses

Projects are tracked through their lifecycle:

💭 Idea Concept stage, planning and gathering parts

🛠️ In Progress Actively building and testing

✅ Completed Working and deployed in production

⏸️ Abandoned Discontinued (but documented for future reference)

How to Contribute

Found an error? Have a suggestion?

Report an Issue

Every content page has a "Report an Issue" button that opens a GitHub issue with the page details pre-filled. Use this to report errors, broken links, or outdated information.

Suggest a Feature

Have an idea for a new feature or improvement? Open a feature request on GitHub with your suggestion.

View on GitHub → Open an Issue →

AI Usage Disclosure

This project would have not been possible without support of AI tools (GitHub Copilot in particular). I would not have the time to organize all of this and make a website out of it. Nearly all the code for the technical side of the website was generated by Copilot.

Some content may have been generated, reviewed, or improved using AI tools (GitHub Copilot). In general, the content that is generated are placeholders for the new device detail files and the likes. If generated, the AI tool is fed my notes, code, reference links, where I bought the device if I had that information etc. It is just to speed up giving structure to the content. All the content is then reviewed by me for accuracy.

All the ESPHome YAML code for ESPHome is written and tested by humans. All explanations, guides and personal notes are written by humans. No images or videos are, or will be generated by AI unless specifically stated. This text is written by a human 🤖.