https://github.com/ghmeier/arppush
Push arp scans to a url
https://github.com/ghmeier/arppush
arp attendance-monitoring networking
Last synced: about 2 months ago
JSON representation
Push arp scans to a url
- Host: GitHub
- URL: https://github.com/ghmeier/arppush
- Owner: ghmeier
- Created: 2017-03-23T00:25:01.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-04-18T19:55:03.000Z (over 9 years ago)
- Last Synced: 2025-12-10T06:48:06.362Z (8 months ago)
- Topics: arp, attendance-monitoring, networking
- Language: JavaScript
- Size: 4.88 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# arppush
POST the results of arp-scan to a url to consumption
## Usage
To get up and running you'll first need to install `arp-scan` on either MacOS or Linux.
**MacOS** [Use Brew](http://brewformulas.org/ArpScan)
```
brew install arp-scan
```
**Linux**
```
sudo apt-get install arp-scan
```
or
```
sudo dnf install arp-scan
```
Then, make sure you have `nodejs` and `npm` [ready to go](https://nodejs.org/en/download/).
Now clone this repo:
```
git clone git@github.com:ghmeier/arppush
cd arppush
npm install
```
We're ready to add configuration:
1. Find your wireless interface id using `ifconfig` or similar
2. Add that and the destination url (from [autohat](https://github.com/yuderekyu/autohat)) to a file called `config.json` in the root directory like this:
```
{
"url": "https://.herokuapp.com/api/arppush",
"ifc": "eth0"
}
```
Finally, **run it like this:**
```
npm start
```
This will run arp-scan periodically, and post it to the provided url in this form:
```
{
'AC:CF:23:31:9B:FC': {
ip: '192.168.1.1',
mac: 'AC:CF:23:31:9B:FC',
vendor: 'Cisco-Linksys, LLC',
timestamp: 1427686747854
},
'AC:CF:23:31:9B:33': {
ip: '192.168.1.132',
mac: 'AC:CF:23:3F:9B:33',
vendor: 'Raspberry Pi Foundation',
timestamp: 1427686747854
},
'b8:e9:37:11:d5:5c': {
ip: '192.168.1.140',
mac: 'b8:e9:37:11:d5:5c',
vendor: 'Sonos, Inc.',
timestamp: 1427686747854
}
}
```
## Development
If you find bugs, additions, etc. please for the repo and toss me a PR, I'll look it over!