Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kognise/arpchat
Answering the question nobody asked: what if you wanted to text your friends using only ARP?
https://github.com/kognise/arpchat
arp chat
Last synced: about 11 hours ago
JSON representation
Answering the question nobody asked: what if you wanted to text your friends using only ARP?
- Host: GitHub
- URL: https://github.com/kognise/arpchat
- Owner: kognise
- License: other
- Created: 2022-03-21T03:29:09.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-08-15T15:25:08.000Z (over 1 year ago)
- Last Synced: 2024-12-14T01:06:14.220Z (8 days ago)
- Topics: arp, chat
- Language: Rust
- Homepage:
- Size: 90.8 KB
- Stars: 2,497
- Watchers: 19
- Forks: 50
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- starred - kognise/arpchat - Answering the question nobody asked: what if you wanted to text your friends using only ARP? (Rust)
README
# arpchat
so... you know arp? the protocol your computer uses to find the mac addresses of other computers on your network? yeah. that.
i thought it would be a great idea to hijack it to make a chat app :)
built in two days because i was sick and had nothing better to do.
![screenshot of the tool in action](https://doggo.ninja/RJGHYH.png)
## motivation
1. once a year, i'm on a client isolated network that i want to chat with friends over
2. i'm completely insane
3. i'm a programmer(i swear, i might actually briefly have a use for this! it might not be entirely useless! ... and other lies i tell myself)
## limitations
yes
## things i made arpchat do
you can send messages tens of thousands of characters long because i implemented a (naive) generalizable transport protocol on top of arp. there's also a bit of compression.
if you wanted, you could probably split off the networking part of this and use it instead of udp. please don't do this.
not only are join and leave notifications a thing, i built an entire presence discovery and heartbeat system to see an updated list of other online users. ironically, part of this serves a similar purpose to arp itself.
for more information on how this all works technically, check out [the little article i wrote](https://kognise.dev/writing/arp).
## running
if you actually want to install this for some reason, you can get it from [the releases page](https://github.com/kognise/arpchat/releases/latest).
on windows, you probably need [npcap](https://npcap.com/#download). make sure you check "Install Npcap in WinPcap API-compatible Mode" in the installer!
on linux, you might have to give arpchat network privileges:
```sh
sudo setcap CAP_NET_RAW+ep /path/to/arpchat
```![interface selector](https://doggo.ninja/tvFJ2A.png)
then just run the binary in a terminal. you know it's working properly if you can see your own messages when you send them. if you *can't* see your messages, try selecting a different interface or protocol!
have any issues? that really sucks. you can make an issue if it pleases you.
## building
you don't really want to build this. anyway, it's tested on the latest unstable rust.
on windows, download the [WinPcap Developer's Pack](https://www.winpcap.org/devel.htm) and set the `LIB` environment variable to the `WpdPack/Lib/x64/` folder.
```sh
cargo build
```![banner](https://doggo.ninja/fH9GKt.png)