2
5
Fork
You've already forked SensorCube
0
Small (8 cm)3, open-source, ESP32-powered, IoT air quality measuring device with audio/visual alerts and WiFi (MQTT).
  • C 94.1%
  • C++ 3.2%
  • Shell 2%
  • Makefile 0.4%
  • CMake 0.3%
2026年06月27日 14:51:03 +02:00
assets Move seal sketches 2026年04月16日 21:47:52 +02:00
components/embedded-i2c-sen66 add sen66 HAL 2025年12月26日 13:31:23 +01:00
docs Update docs/development_guide.md 2026年06月27日 14:51:03 +02:00
main Update build pipeline 2026年04月16日 17:35:22 +02:00
scripts Update build pipeline 2026年04月14日 20:47:00 +02:00
.clang-format initial commit 2025年12月26日 13:28:27 +01:00
.clangd initial commit 2025年12月26日 13:28:27 +01:00
.env_example Fix .venv not getting exported 2026年06月27日 13:35:42 +02:00
.gitignore Update build pipeline 2026年04月16日 17:35:22 +02:00
.python-version Update build pipeline 2026年04月14日 20:47:00 +02:00
.shellcheckrc initial commit 2025年12月26日 13:28:27 +01:00
CMakeLists.txt Update build pipeline 2026年04月16日 17:35:22 +02:00
dependencies.lock Update build pipeline 2026年04月16日 17:35:22 +02:00
dev_build Update build pipeline 2026年04月16日 17:35:22 +02:00
dev_init Fix peek command not found in dev_init 2026年05月16日 22:06:37 +02:00
dev_start.fish Fix .venv not getting exported 2026年06月27日 13:35:42 +02:00
dev_start.sh Update build pipeline 2026年04月14日 20:47:00 +02:00
LICENSE initial commit 2025年12月26日 13:28:27 +01:00
README.md Move index below images 2026年04月17日 11:14:37 +02:00
sdkconfig Update build pipeline 2026年04月14日 20:47:00 +02:00

Sensor Cube

A small (8 cm)3, open-source, ESP32-powered, IoT air quality measuring device with audio/visual alerts and WiFi (MQTT).

Want to build your own? Visit the guide!

Render Photo
Render of the Sensor Cube Photo of the Sensor Cube

Index

Features

  • 🔎 Measures:
  • 💡 Visual alerts via RGB LED and IPS display
  • 🔊 Audio alerts via buzzer
  • 🛜 MQTT interface for Smart Home integration
  • 🔋 Integrated battery w/ charging for cordless operation
  • 💤 Low power consumption with deep sleep support *
  • 📦 Compact 3D printed enclosure
  • 💅 Minimal soldering required
  • 🖥️ Simple user-interface with system settings
  • 📋 Many more features planned, see todo.md

* Not yet implemented

Technical Specifications

* A future iteration may work with more generic ESP32 boards with a separate display and buttons.

Firmware Installation

Simple

  1. Download a pre-built firmware from the releases page.
  2. Follow the flashing guide.

Advanced

Build your own, customized variant of the firmware by following the development guide.

Motivation

The author developed it as part of a personal learning exercise. It is her first ESP32 project and her first major C project overall. Nevertheless she strived for the following goals:

  • Small physical form factor
  • Little to no soldering
  • As few components as possible
  • Optimal sensor placement
  • Intuitive and minimalistic UI/UX

Inspiration

  • Arduino LLC
  • Limor "Ladyada" Fried
  • Simone Giertz
  • Thomas Sanladerer

Learn More

LLM Statement

The author had previously utilised LLMs for basic autocompletion and refactoring in this project. They have always been strongly opposed to vibe coding, being well aware that it could replace human ingenuity if used incorrectly.

Until LLMs have overcome ethical, environmental and security-related concerns, the author refuses to utilise them any further.

License

All code in ./main/ is licensed under the GPLv3. The case models in ./assets/models/SensorCube/ are licensed under CC BY-SA 4.0.

Other files may have their own license referenced as a sibling file or a comment in the file itself.