{"id":13585742,"url":"https://github.com/mudape/iphonedetect","last_synced_at":"2025-04-07T10:31:38.616Z","repository":{"id":37852689,"uuid":"192604318","full_name":"mudape/iphonedetect","owner":"mudape","description":"A custom component for Home Assistant to detect iPhones connected to local LAN, even if the phone is in deep sleep.","archived":false,"fork":false,"pushed_at":"2025-02-01T13:47:25.000Z","size":154,"stargazers_count":479,"open_issues_count":5,"forks_count":42,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-02-01T14:23:09.765Z","etag":null,"topics":["custom-component","hacs","home-assistant","iphonedetect"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mudape.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-06-18T19:58:07.000Z","updated_at":"2025-02-01T13:35:30.000Z","dependencies_parsed_at":"2025-01-25T11:20:47.497Z","dependency_job_id":"06d0cce7-86cd-40fb-805e-c7528a6c7aaa","html_url":"https://github.com/mudape/iphonedetect","commit_stats":null,"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mudape%2Fiphonedetect","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mudape%2Fiphonedetect/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mudape%2Fiphonedetect/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mudape%2Fiphonedetect/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mudape","download_url":"https://codeload.github.com/mudape/iphonedetect/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247636478,"owners_count":20970940,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["custom-component","hacs","home-assistant","iphonedetect"],"created_at":"2024-08-01T15:05:07.252Z","updated_at":"2025-04-07T10:31:38.605Z","avatar_url":"https://github.com/mudape.png","language":"Python","funding_links":["https://www.buymeacoffee.com/MudApe"],"categories":["Python","Custom Integrations"],"sub_categories":["📍 Presence \u0026 location"],"readme":"# iPhone Detect for Home-Assistant\n\n[![Validate with hassfest](https://github.com/mudape/iphonedetect/actions/workflows/hassfest.yaml/badge.svg)](https://github.com/mudape/iphonedetect/actions/workflows/hassfest.yaml)\n[![HACS Validate](https://github.com/mudape/iphonedetect/actions/workflows/hacs_action.yml/badge.svg)](https://github.com/mudape/iphonedetect/actions/workflows/hacs_action.yml)\n[![hacs_badge](https://img.shields.io/badge/HACS-Default-blue.svg)](https://github.com/custom-components/hacs)\n\n![downloads](https://img.shields.io/github/downloads/mudape/iphonedetect/total.svg)\n![downloads](https://img.shields.io/github/downloads/mudape/iphonedetect/1.4.2/total.svg)\n![downloads](https://img.shields.io/github/downloads/mudape/iphonedetect/latest/total.svg)\n\nThis integration sends a mDNS message to defined hosts.  \nThe 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.  \nUsefull 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.\n\n## Installation\n\nAfter installation you need to **restart** Home-Assistant before using the integration.\n\n### Using HACS  \n\nIf you dont' have [HACS](https://hacs.xyz) installed yet, I highly recommend it.  \n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=mudape\u0026repository=iphonedetect\u0026category=integration) or search for `iPhone Device Tracker`.\n\n### Manual  \n\nDownload the `iphonedetect` directory and place in your `\u003cconfig\u003e/custom_component`\n\n## Configuration  \n\n### Network\n\nAssign a **static** IP address to the device you want to track, probably in your router.  \nAlternative, set a manual IP in your device WiFi configuration.  \nAvoid automatically connect to differtent SSID's (2.4 and 5 ghz bands)  \n\n### Setup\n\n[![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=iphonedetect)\n\nIf you don't have [My Home Assistant](https://my.home-assistant.io/) redirects set up, go to Settings -\u003e Devices \u0026 Services  \nClick \"Add integration\" and search for `iPhone Device Tracker`\n\nGive the entity a unique `name` and enter its IP address.  \n\n![image](https://github.com/user-attachments/assets/c4583955-72d8-4c3a-81b4-062a134af11e)\n\nThis will create an entity `device_tracker.\u003cname\u003e`  \n\nRepeat the steps for additional entities.\n\n#### Options\n\nYou can change the consider home timeout per tracked device in the UI.  \nDefault is 24 seconds.  \n![image](https://github.com/user-attachments/assets/caf31775-333d-448c-b8f2-660534d856d7)\n\n#### Reconfigure\n\nYou can change the IP address of the tracked device in the UI.  \n![image](https://github.com/user-attachments/assets/4fc98224-eee6-4451-aaf1-b16c858014d2)\n\n## Troubleshooting | FAQ  \n\n\u003cdetails\u003e\n\u003csummary\u003ePrivate Wi-Fi address\u003c/summary\u003e\nThe 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.  \n\nIn 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.  \n\u003cbr /\u003e\nNote 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.  \nMost likely that will require the integration to track two IP's per user/Person.\n\u003cbr /\u003e\nSo, for best result only have/connect to one SSID, turn off private network and assign static IP.\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003eFalse or flaky not_home status\u003c/summary\u003e\nEspecially when the network has multiple Access Points, tracked devices sometimes are marked as not_home when actually connected to the network.  \nIncreasing the consider home timeout might help this.  \nMost likely it's a network issue though, try placing your AP's at different locations.  \n\nDevices might auto-update during night, they of course then will be not_home for awhile.  \n\u003c/details\u003e\n\n## Attribution\n\nOriginal idea from [return01](https://community.home-assistant.io/u/return01)\n\n## Disclaimer  \n\nAuthor is in no way affiliated with Apple Inc.  \nAuthor does not guarantee functionality of this integration and is not responsible for any damage.  \nAll product names, trademarks and registered trademarks in this repository, are property of their respective owners.  \n\n\u003ca href=\"https://www.buymeacoffee.com/MudApe\" target=\"_blank\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" alt=\"Buy Me A Coffee\" style=\"height: auto !important;width: auto !important;\" \u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmudape%2Fiphonedetect","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmudape%2Fiphonedetect","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmudape%2Fiphonedetect/lists"}