https://github.com/stickpin/homebridge-people-arp
Homebridge plugin that provides details of who is in a Home + History (powered by fakegato) based on IP and MAC Address
https://github.com/stickpin/homebridge-people-arp
Last synced: 17 days ago
JSON representation
Homebridge plugin that provides details of who is in a Home + History (powered by fakegato) based on IP and MAC Address
- Host: GitHub
- URL: https://github.com/stickpin/homebridge-people-arp
- Owner: stickpin
- License: mit
- Created: 2019-12-20T22:53:56.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-06-08T15:50:18.000Z (almost 5 years ago)
- Last Synced: 2025-05-05T22:11:38.969Z (18 days ago)
- Language: JavaScript
- Size: 9.77 KB
- Stars: 9
- Watchers: 3
- Forks: 3
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# homebridge-people-arp
This is a plugin for [homebridge](https://github.com/nfarina/homebridge).
It monitors who is at home, based on their smartphone being seen on the network recently.
Monitoring done using Ping->ARP sequence to increase accuracy.
People displayed as Contact/Door/Window sensor which allow you to triffer notifications when somebody enters or leaving the home (network).
If you use the EVE.app you can also see the presence history of every person-sensor (powered by fakegato)
# Installation
1. Install homebridge (if not already installed) using: `npm install -g homebridge`
2. Install this plugin using: `npm install -g --unsafe-perm homebridge-people-arp`
3. Update your configuration file. See below for a sample.
# Configuration
```
"platforms": [
{
"platform": "PeopleARP",
"threshold" : 3,
"checkInterval": 10000,
"people" : [
{
"name" : "Pete",
"target" : "PetesiPhone",
"macAddress" : "de:ef:38:29:0c:28",
"threshold" : 3,
"checkInterval": 10000
},
{
"name" : "Someone Else",
"target" : "192.168.1.68",
"macAddress" : "64:2e:fb:8b:41:7b",
"threshold" : 3,
"checkInterval": 10000
}
]
}
]
```
| Parameter | Note |
|----------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `threshold` | optional, in minutes, default: 3 |
| `checkInterval` | optional, in milliseconds, default: 10000. minimal value: 10000 |
| `target` | may be either a hostname or IP address |
| `macAddress` | mac address of the device |
| `name` | a human-readable name for your sensor |
# Thanks
Thanks to everyone who's helped contribute code, feedback and support. In particular:
* [PeteLawrence](https://github.com/PeteLawrence/homebridge-people) - for the original plugin
* [skrollme](https://github.com/skrollme/homebridge-people-x) - for the plugin which this one is forked from
* [simont77](https://github.com/simont77/fakegato-history) - for the fakegato-plugin