Skip to content

stoiandan/Howdy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Howdy

Howdy helps you discover all your local LAN machines, including macOS, Windows and Linux. It's able to tell your their mDNS names.

How?

Howdy makes use of Apple's Bonjour, a zero-configuration netwoork service, via Network.framework.

It uses its very own protocol called zero, build on top of TCP/IP. It's a simple protocol, really. It contains a fixed sized header of 8 bytes that represents an UInt, declering the size of future json encoded hostname (for Unicode support 😃):

image

So, every time a app instance starts, it publishes it's service on mDNS (Bonjour) and browse over other avlaible service on the local netowrk. If it finds one, it sends it's hostname via the Howdy (zero) protocol.

Here's and example of a Howdy instnace listing other three machines on the network:

image

To simulate these machines. I've used the dns-sd UNIX command to search for Bonjour services and resolve the port. I've then used netcat (nc) combined with echo to send an 8 byte UInt header via UDP and a plain-text string (for demo purposes):

echo -n -e '\x09\x00\x00\x00\x00\x00\x00\x00bar.local' | nc -u localhost 65172

Why?

While macOS's Finder does a good job in listing computers, sometimes they're simply not listed (probably because of OS policies) and not enough info is available (for example the IP Address). Howdy allows you to retireve all that, without lowering security, it also gives you more info.

Plans are to also allow file transfer via Howdy this is a good alternative to file sharing, as you don't have to start a share and turn it off, for sercutity, if all you want is to transfer.