Python GPL-3.0

hass-FindMy

Custom Home Assistant integration for Apple's FindMy network.

M

malmeloo

Dernière activité 28 sept. 2026
malmeloo/hass-FindMy

243

étoiles

25

forks

3

issues ouvertes

Ce README est souvent en anglais.

FindMy - Home Assistant integration

Experimental custom integration to provide device tracker entities for FindMy Network-enabled devices.

Setting up

  1. Add this repository to HACS and install the FindMy integration.
  2. Enable the integration. You must add at least two 'devices': one Apple Account and one tracker device.
    1. When adding an account, you will need to specify an anisette server. You can use a public one, but it might start throwing errors after a while, so private servers are preferred. Google is your friend.
  3. Enjoy!

Increasing the update frequency

By default, the integration will only use your account to fetch for updates once per 15 minutes. This is to reduce the risk of being banned by Apple. If you want to increase the tracker update frequency, it is possible to add additional accounts. These accounts will divide the available time; 2 accounts will generate updates every 7.5 minutes, 3 will update every 5 minutes, etc.

Local Bluetooth tracking

Rolling-key accessories such as official AirTags can also be detected by Home Assistant Bluetooth adapters and ESPHome Bluetooth proxies. Local detections update independently of the 15-minute Find My network polling interval.

The device tracker exposes the confirmed current address in mac_address and adds these attributes:

  • local_detected_at
  • local_rssi
  • local_source
  • local_state (nearby or separated)
  • local_battery (Full, Medium, Low, or Very Low)
  • local_key_candidates

All key matching happens inside Home Assistant. Local presence tracking therefore continues without an internet connection after the rolling-key accessory has been imported, although remote Find My network locations still require an Apple account and internet access.

Projets similaires

🍏 + 🎯 + 🐍 = Query Apple's FindMy Network with Python!

Pythonairtagapplebluetooth
Mmalmeloo
3,3 k étoiles148

Google FindMy device tracker integration for Home Assistant

Pythondevice-trackinghacs-integrationintegrations
BBSkando
368 étoiles25

Build your own 'AirTags' 🏷 today! Framework for tracking personal Bluetooth devices via Apple's massive Find My network.

Swiftairtagapplebluetooth
Sseemoo-lab
13,7 k étoiles691