2.1 KiB
LookAround
"I want to 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. There's no central server, so it's not a look-up, it's a look-around.
$ lookaround client
Found 3 peers:
11:11:11:11:11:11 = 192.168.1.101 `laptop`
22:22:22:22:22:22 = 192.168.1.102 `desktop`
33:33:33:33:33:33 = 192.168.1.103 `old-laptop`
The LookAround client uses IP multicast to find LookAround servers within the same multicast domain.
MAC addresses change slower than IP addresses, so if you know that
11:11:11:11:11:11 is your laptop, and your laptop is running LookAround,
LookAround will find the IP for you.
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=/home/user/.cargo/bin/lookaround server --nickname my-desktop
[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
This Git repo
This repo's upstream is https://six-five-six-four.com/git/reactor/lookaround. It's mirrored on my GitHub, https://github.com/ReactorScram/lookaround
I don't use GitHub issues, so issues are in issues.md in the repo.