Skip to content

πŸ“¬ PuffiMail - A Smart Mailbox Notifier

PuffiMail is a low-power smart mailbox detection device based on the XIAO ESP32-C3 and VL53L0X time-of-flight distance sensor.
It detects whether new mail has arrived in the mailbox and sends real-time updates via Wi-Fi using MQTT.
Seamlessly integrates with platforms like Home Assistant.

puffimailview

✨ Key Features

  • ⚑ Ultra Low Power: Uses deep sleep mode to minimize energy consumption; wakes only on trigger or hourly timer.
  • πŸ“ Distance-Based Mail Detection: VL53L0X sensor detects objects with up to 2mm precision, suitable for most letters except postcards.
  • 🧠 Smart Detection Algorithm: Baseline calibration with multiple sample filtering ensures stable and accurate results.
  • πŸ”‹ Battery Monitoring: Reads battery voltage and reports low-battery warnings via MQTT.
  • 🌐 Web Configuration (AP Mode): Easily configure Wi-Fi and MQTT settings from a built-in multi-language web portal.
  • πŸ“‘ MQTT Integration: Publishes mail status, distance, and battery info to MQTT broker; fully compatible with Home Assistant.
  • πŸ” OTA Firmware Update: Upload .bin firmware through browserβ€”no cable or external tools needed.
  • 🌍 Multilingual Interface: Built-in UI supports English, ζ—₯本θͺž, and δΈ­ζ–‡.

πŸ’‘ Open Source

PuffiMail is an open-source project, licensed under the MIT License.
You are welcome to use, modify, or extend it in your own smart home ecosystem.

πŸ”— GitHub Repository: https://github.com/puffilab/puffimail

Whether you're a maker, hobbyist, or just want a smarter mailbox, PuffiMail is your perfect entry into practical IoT.