Send files straight from one computer to another, peer to peer. No accounts, no upload server, no public links.
gofer send holiday.zip annamacOS / Linux
curl -fsSL https://github.com/NZ-Linix/gofer/releases/latest/download/install.sh | shWindows (PowerShell)
irm https://github.com/NZ-Linix/gofer/releases/latest/download/install.ps1 | iexUpdate later with gofer update. With Go installed you can also run
go install github.com/NZ-Linix/gofer/cmd/gofer@latest.
gofer login anna # once per device: pick a username
gofer receive # stay online; asks before accepting each file
gofer send report.pdf ben # send to whoever is logged in as "ben"| Command | |
|---|---|
gofer login <username> |
Set your username (3–32 chars: a-z 0-9 . _ -) |
gofer whoami |
Show your username and peer ID |
gofer receive [--dir D] [--yes] [--port N] [-v] |
Receive files (default: ~/Downloads) |
gofer send <file> <username> |
Send a file |
gofer contacts [add <name> <id> | rm <name>] |
Manage pinned contacts |
gofer update |
Update to the latest release |
- Identity. Each device has an Ed25519 key in
~/.gofer. Its peer ID is derived from that key. - Discovery.
gofer receiveannounces username → peer ID on the public libp2p / IPFS DHT. There is no gofer server. - Connection. If the receiver is behind a NAT, a public libp2p relay helps the two sides hole-punch a direct connection. The file itself always travels over that direct connection. gofer refuses to send over a relay.
- Integrity. Data is encrypted in transit (Noise/TLS). The receiver checks a SHA-256 of the file before saving it.
Usernames are not globally unique: anyone can announce any name. gofer pins a username to
the peer ID the first time you send to it (trust on first use). For important transfers,
compare the pinned peer ID with the output of gofer whoami on the other device, or pin it
up front with gofer contacts add.
- The receiver must be running
gofer receive. - If both sides are behind strict (symmetric) NATs, hole punching can fail. Then forward a
port on the receiver's router and run
gofer receive --port <n>. - Sends single files. Zip folders first.
cmd/gofer/ CLI entry point and commands
internal/config/ identity key, username, contacts (~/.gofer)
internal/p2p/ libp2p host, DHT bootstrap and announce
internal/transfer/ wire protocol, sender and receiver
internal/ui/ progress bar and spinner
internal/update/ self-update from GitHub releases
install.sh, install.ps1
make build # ./gofer
make test
make dist # cross-compile all targets into dist/Set GOFER_HOME=/some/dir to run a second identity on the same machine.
Releases are built by GitHub Actions when you push a v* tag.