Go to file

_ cdd49cdc5a 📝 preparing to publish		2021-12-05 23:53:32 +00:00
src	repeat the request 10 times, slower	2021-12-05 20:42:56 +00:00
.gitignore	🐣 so that's how multicast groups work	2021-11-26 21:46:27 +00:00
COPYING	📝 preparing to publish	2021-12-05 23:53:32 +00:00
Cargo.lock	add a request ID so I can re-send it. (I forgot UDP is unreliable, lol)	2021-12-05 20:40:37 +00:00
Cargo.toml	add a request ID so I can re-send it. (I forgot UDP is unreliable, lol)	2021-12-05 20:40:37 +00:00
README.md	📝 preparing to publish	2021-12-05 23:53:32 +00:00

README.md

LookAround

"I want SSH into my laptop, but I keep forgetting its IP!!"

Has this ever happened to you?

LookAround is a Rust program for looking up your computers' MAC and IP addresses within a LAN.

$ lookaround client

Found 3 peers:
11:11:11:11:11:11 = 192.168.1.101:9040 # Your laptop
22:22:22:22:22:22 = 192.168.1.102:9040 # Your desktop
33:33:33:33:33:33 = 192.168.1.103:9040 # Your home server
# MAC address       IP address

The LookAround client uses IP multicast to find LookAround servers within the same multicast domain.

Installation

Use the Cargo package manager from Rust to install LookAround.

cargo install lookaround

To run the server as a normal user all the time, put this systemd unit in ~/.config/systemd/user/lookaround.service:

[Unit]
Description=LookAround

[Service]
ExecStart=lookaround server

[Install]
WantedBy=default.target

Then start the service, check that it's running okay, and enable it for auto-start:

systemctl --user start lookaround
systemctl --user status lookaround
systemctl --user enable lookaround

Usage

Run the server manually: (If you haven't installed it with systemd yet)

lookaround server

Run a client to ping all servers in the same multi-cast domain:

lookaround client

Contributing

Pull requests are welcome. This is a hobby project, so I may reject contributions that are too big to review.

Use the kazupon Git commit message convention

License

AGPL-3.0