Skip to content

ESPresense

ESPresense turns inexpensive ESP32 boards into a home-wide indoor positioning system. Mount a few nodes around the house, run the companion service, and Home Assistant can tell which room a phone, watch, or BLE tag is in. Open-source firmware, open-source server, open data.

Who it's for

  • Homeowners who want presence-based automation that actually works room-to-room.
  • Home Assistant users who want room-level presence instead of just home/away — multiple nodes working together, not one sensor guessing near/far.
  • Makers and tinkerers building on top — custom enclosures, new device classes, accuracy research.

Flagship repos

  • ESPresense — ESP32 firmware. Flash it on a node, point it at MQTT, and you have a BLE/iBeacon scanner that publishes to Home Assistant's mqtt_room integration.
  • ESPresense-companion — Home Assistant add-on / Docker container that fuses readings from multiple nodes into real (x, y, z) positions on your floorplan.
  • ESPresense.com — source for the docs site. Setup guides, supported hardware, calibration walkthroughs.

Need help?

  1. GitHub Discussions — first stop for setup questions, calibration, "is X supported?", and anything someone else might ask later. Search before posting.
  2. Discord — faster turnaround, real-time troubleshooting, hardware swaps.
  3. File an issue — once it's confirmed a bug or a concrete feature gap. Include firmware version, board, and what you tried.

Contributing

PRs welcome across every flagship repo. Start with CONTRIBUTING.md on the firmware repo, then say hi on Discord so we know what you're working on.

Star History

Star History Chart

Pinned Loading

  1. ESPresense ESPresense Public

    An ESP32 based node for gathering indoor positioning and transmitting to mqtt

    C 1.4k 177

  2. ESPresense-companion ESPresense-companion Public

    HA Add-on / Docker container that solves indoor positions with mqtt data received from multiple ESPresense nodes

    C# 212 20

Repositories

Showing 10 of 28 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Sponsors

  • @mrizzo123
  • @tioan

Top languages

Loading…

Most used topics

Loading…