Hooray
======

Find devices around you. Fast and without hyphens.

    gem install hooray


And use the executable `hoo`:


```
hoo list
```
```
NAME                        | IP            | MAC
----------------------------|---------------|------------------
Motorola Mobility           | 192.168.1.70  | 34:bb:XX:XX:XX:XX
Giga-byte Technology Co.    | 192.168.1.71  | 94:de:XX:XX:XX:XX
Veih's Android              | 192.168.1.72  | 04:46:XX:XX:XX:XX
Nery's LG                   | 192.168.1.73  | cc:fa:XX:XX:XX:XX
nofxx's iPhone              | 192.168.1.77  | 64:a3:XX:XX:XX:XX
LG Electronics              | 192.168.1.79  | cc:fa:XX:XX:XX:XX
TP-Link                     | 192.168.1.253 | f8:d1:XX:XX:XX:XX
Siemens Subscriber Networks | 192.168.1.254 | 00:0b:XX:XX:XX:XX
---
8 devices @ 2014-12-11 13:32:04 -0200 2.27s
```


## Find running services

```
hoo list web
```
```
NAME              | IP           | MAC
------------------|--------------|------------------
dsl modem         | 192.168.1.1  | 64:a3:XX:XX:XX:XX
test server       | 192.168.1.75 | 64:a3:XX:XX:XX:XX
nofxx desktop     | 192.168.1.77 | 64:a3:XX:XX:XX:XX
---
3 devices @ 2014-12-11 19:23:11 -0200 1.10s
```

Or simply by ports:


```
hoo list 80
hoo list 6777 udp
```

## Monitor

```
hoo watch
```
```
New nodes @ 2014-12-11 13:53:06 -0200
NAME       | IP           | MAC
-----------|--------------|------------------
myphone    | 192.168.1.76 | 64:a3:XX:XX:XX:XX
```


## Use another program

```
hoo ssh myphone
```

Will execute: `ssh <ip of myphone>`

You can use any program, not just ssh.


## Use as a lib

```
require 'hooray'
Hooray::Seek.lan(port, protocol).devices
Hooray::Seek.new(network, port, protocol).devices
```

* Nil port means ICMP ping.
* Protocol always defaults to :tcp.
* Network defaults to LAN IP 24 bits masked.

Possible protocols: tcp, udp, http, wmi & icmp (requires root).


## Why?

Bind macs or fix IP's is also boring and a per device work.
As more we use wifi/ethernet devices in our company, nmap gets boring.
Not to mention slow, there's no easy way to assign names to devices I know,
which makes OS scan/port scan a needed option most times (thus making it slower).
Also (please open a issue if you know how) even in fast mode nmap won't run in under 2s.
And, on recent updates, you need sudo for all of that.

## How?

```
hoo init
```

A ~/.horray folder is prepopulated:
devices.yml regex list you mac addresses with names you recognize.
services.yml regex list ports to names you recognize.


## Credits

* Ruby net-ping gem.
* Nmap`s mac precompiled prefixes.


Hooray should work on UNIX based systems.
Tested in Linux and OS X.