gbroeckling /padspanHA

Bluetooth room presence for Home Assistant. Shows which room every iPhone, Android phone, Apple Watch and tag is in, live, on a 3D floor plan of your house. Works with the ESPHome or Shelly Bluetooth proxies you already have, and runs next to Bermuda or ESPresense. Try it in your browser: padspan.traks.ca/demo

★ 300⑂ 18👁 3⑃ 19● 75▤ 1,250
JavaScriptGPL-3.0Created 2026-02-05padspan.traks.ca/demo/
下载:v0.38.231v0.38.231 ↓0.38.2312026-11-11
+0
日增长
300
stars
18
forks
3
watchers
19
prs
75
issues
1,250
releases

README

PadSpan™ HA

 See which room every phone, watch and tag is in, live, on a plan of your home



PadSpan is a Home Assistant integration for Bluetooth room presence. It listens to the Bluetooth proxies you already have, works out which room each phone, watch, tag and beacon is in, every 5 seconds, and shows it on a plan of your home: one floor at a time or all floors stacked. Your automations get room, distance and home/away sensors. The tracking runs locally.

▶️ Try it in your browser: padspan.traks.ca/demo, the real panel on a sample house. Nothing to install.

 Install: one click opens PadSpan in Settings → Marketplace (Home Assistant 2026.11 and newer) or in HACS (older versions). Or search either one for PadSpan.

What you need: Home Assistant 2024.1 or newer and at least one Bluetooth scanner: an ESPHome Bluetooth proxy, a Shelly Gen2 or newer set as a Bluetooth scanner (one setting), your Home Assistant machine's own Bluetooth, or an ESPresense node. One tells you home or away; one in each room you want told apart gives you rooms. How many proxies do I need? Already running Bermuda? Keep it: PadSpan runs next to it.

Free and open source (GPL-3.0). PadSpan Pro adds exact placement on the Atlas, the touchscreen map of the whole house, plus Live Aboard (your house in 3D, like looking into a house in The Sims) and Furnish. Try all of Pro free for 90 days, no card. The anonymous usage report stays on during the trial (how it works).

🎁 PadSpan Pro free: testers get two years of Pro while the anonymous usage report stays on (how), and until December 31 the first 20 people to ask get a year (details).

🌐 Website: padspan.traks.ca · 📖 Guides: From the Marketplace to your first room · What can Home Assistant do once it knows the room? · Bermuda, NeonPlan 3D or PadSpan? · Which room is my phone in? · Which Bluetooth tag works? · Why does my phone jump between rooms? · How many Bluetooth proxies do I need? · Your Shellys can be Bluetooth proxies · Which floor plan for Home Assistant? · Your robot vacuum's map as your floor plan · Every floor of a big house on one wall · Which touch screen for a PadSpan wall? · Bermuda and PadSpan together · all guides · 🎬 Making a video or article? The creators kit

The tour is the real panel on the demo's sample house, at real speed, with captions added. The full walkthrough video is on padspan.traks.ca.

---

 Why PadSpan?

Most BLE presence integrations give you a config flow and a sensor. PadSpan gives you a complete tracking workstation — floor plan editor, room boundary polygons, 3D isometric maps, walk-around calibration, follow mode with email alerts, a training hub, and a full sample/demo mode so you can explore every feature before plugging in hardware.

It works with your existing BLE scanners. HA Bluetooth proxies (ESPHome, or Shelly Gen2+ set as a Bluetooth scanner) and Bermuda proxies are picked up directly; ESPresense nodes come in over MQTT, which you switch on in Manage → HA Entities → ESPresense MQT

Top issues

Discussions

Latest release

v0.38.231 v0.38.231 2026-11-11
PadSpan HA v0.38.231 (STABLE)

The stable after 0.38.224: lighting scenes under the Atlas, Show on this screen, a chosen floor fills the Atlas, how much AI you use, merge rooms and edit corners in Mapping - Rooms, and two experimental plan tools (Line up plans, Rooms from plans).

 Install / Update
Install or update via HACS: search for PadSpan HA (it is in the HACS default list).

 PadSpan Pro free
Testers get two years of PadSpan Pro while the anonymous usage report stays on: Settings → Tracking → Help improve PadSpan. More ways: https://padspan.traks.ca/pro-free

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON