https://github.com/mudape/iphonedetect
A custom component for Home Assistant to detect iPhones connected to local LAN, even if the phone is in deep sleep.
https://github.com/mudape/iphonedetect
custom-component hacs home-assistant iphonedetect
Last synced: about 1 year ago
JSON representation
A custom component for Home Assistant to detect iPhones connected to local LAN, even if the phone is in deep sleep.
- Host: GitHub
- URL: https://github.com/mudape/iphonedetect
- Owner: mudape
- License: mit
- Created: 2019-06-18T19:58:07.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2025-02-01T13:47:25.000Z (over 1 year ago)
- Last Synced: 2025-02-01T14:23:09.765Z (over 1 year ago)
- Topics: custom-component, hacs, home-assistant, iphonedetect
- Language: Python
- Homepage:
- Size: 150 KB
- Stars: 479
- Watchers: 12
- Forks: 42
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-home-assistant - iPhone Detect - Detect iPhones (and other phones) on the local Wi-Fi without an app, by sending a UDP probe and watching for the reply (619★). (Custom Integrations / 📍 Presence & location)
README
# iPhone Detect for Home-Assistant
[](https://github.com/mudape/iphonedetect/actions/workflows/hassfest.yaml)
[](https://github.com/mudape/iphonedetect/actions/workflows/hacs_action.yml)
[](https://github.com/custom-components/hacs)
This integration sends a mDNS message to defined hosts.
The device responds if it's connected to the network, even when in deep sleep, and an entry in the ARP cache is made and read.
Usefull as a [device_tracker](https://www.home-assistant.io/integrations/device_tracker/) for your [person](https://www.home-assistant.io/integrations/person/) integration to see if users are at home.
## Installation
After installation you need to **restart** Home-Assistant before using the integration.
### Using HACS
If you dont' have [HACS](https://hacs.xyz) installed yet, I highly recommend it.
[](https://my.home-assistant.io/redirect/hacs_repository/?owner=mudape&repository=iphonedetect&category=integration) or search for `iPhone Device Tracker`.
### Manual
Download the `iphonedetect` directory and place in your `/custom_component`
## Configuration
### Network
Assign a **static** IP address to the device you want to track, probably in your router.
Alternative, set a manual IP in your device WiFi configuration.
Avoid automatically connect to differtent SSID's (2.4 and 5 ghz bands)
### Setup
[](https://my.home-assistant.io/redirect/config_flow_start/?domain=iphonedetect)
If you don't have [My Home Assistant](https://my.home-assistant.io/) redirects set up, go to Settings -> Devices & Services
Click "Add integration" and search for `iPhone Device Tracker`
Give the entity a unique `name` and enter its IP address.
This will create an entity `device_tracker.`
Repeat the steps for additional entities.
#### Options
You can change the consider home timeout per tracked device in the UI.
Default is 24 seconds.
#### Reconfigure
You can change the IP address of the tracked device in the UI.
## Troubleshooting | FAQ
Private Wi-Fi address
The device private MAC address will remain the same for each network, as long as the network isn't recreated or rotating (iOS 18+) MAC is used.
In other words, if a tracked device no longer can be found the user have propably recreated the connection to your Wi-Fi forcing a new random MAC address to be used.
Note that if your WiFi has different SSID for the 2.4 and 5 ghz bands, and the phone has private network enabled, two different MAC will be presented to the DHCP.
Most likely that will require the integration to track two IP's per user/Person.
So, for best result only have/connect to one SSID, turn off private network and assign static IP.
False or flaky not_home status
Especially when the network has multiple Access Points, tracked devices sometimes are marked as not_home when actually connected to the network.
Increasing the consider home timeout might help this.
Most likely it's a network issue though, try placing your AP's at different locations.
Devices might auto-update during night, they of course then will be not_home for awhile.
## Attribution
Original idea from [return01](https://community.home-assistant.io/u/return01)
## Disclaimer
Author is in no way affiliated with Apple Inc.
Author does not guarantee functionality of this integration and is not responsible for any damage.
All product names, trademarks and registered trademarks in this repository, are property of their respective owners.
