zerotier/toss is a open-source project on GitHub, written primarily in C. It has 406 stars. Dead simple LAN file transfers from the command line
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
The toss program outputs a token generated from a random local TCP port, the size of the file you're sending, a hash of the file's contents (unless it's a pipe), and all the available IP addresses on all the interfaces in your system. It then listens for catch to connect and if presented with the correct claim token streams the file. If its input is a file it will continue to service catch requests one after the other (not concurrently) until it is terminated with CTRL+C or a kill signal. For pipes it terminates when the pipe closes.
The catch program takes a toss token and then attempts to connect to all the IP addresses specified in it. If connection is successful it listens for a hello message (based on the hashed token) and if this is correct sends a claim message (a different version of the hashed token). If this exchange succeeds toss will send the file and catch will receive it.
To toss a pipe, use toss -. To catch something and pipe it to standard output, use catch <token> -. Both programs send status and error messages to standard error.
The token can include a file name (the part before the slash) but this is optional. If this is not present catch will name the file based on its hash or the output file name provided on the command line.
Transfers are done using TCP over ports between 30000 and 65535. You may have to configure your local firewall to allow this, or at least to allow it between certain IP addresses.
Toss will work across the open Internet if no firewalls are in the way but it's mostly intended for LANs, WiFi networks, and ZeroTier virtual networks (plug, plug! we wrote this!). This little utility serves as an example of how easy things are if devices can communicate directly.
Security
Toss does no encryption and authentication is based on the token alone. Files are checked against a 64-bit hash, but pipes rely on TCP CRC checking alone. If you are transferring sensitive information over an un-trusted insecure network we highly recommend encrypting it with a real crypto tool like GPG or a similar.
The catch command prioritizes private IP addresses and only tries globally scoped IPs after all attempts to use private ones have failed.
Building
On Linux, Mac, and BSD just type make. The source is self-contained and there are no dependencies.
Some work has been done to prepare for a Windows port but this is incomplete. Pull requests are welcome.
License
MIT license.
Changes
Version 1.1: add a DESTDIR to make install and make toss favor ZeroTier and tun/tap interfaces over physical ones. It just lists them first so catch will try them first.
TopGit's last sync did not record any GitHub topics for zerotier/toss. GitHub topics appear in the right sidebar of a repository page; that's the authoritative place to check.
How active is development on zerotier/toss?
The most recent commit recorded on zerotier/toss was 5.2 years ago, based on the GitHub push timestamp. The repository has 22 forks — one of the better signals of community interest.
How many stars does zerotier/toss have?
zerotier/toss has 406 GitHub stars — refresh the page for the live number, or check github.com/zerotier/toss. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What is zerotier/toss?
zerotier/toss (zerotier/toss) is a C project on GitHub. From the project's own README: Dead simple LAN file transfers from the command line
What language is zerotier/toss written in?
zerotier/toss is written primarily in C. GitHub's language field is based on the largest share of bytes in the default branch.
Read full README in the tab above.
Is toss worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of toss.