Send

tuntun send transfers files and directories between machines over the mesh. Transfers are peer-to-peer (no intermediate storage), verified with BLAKE3 hashing via iroh-blobs, and protected by a consent system.

Quick start

# Send a file to a peer
tuntun send ./report.pdf db-server

# Send a directory with a message
tuntun send ./photos laptop --message "from the shoot"

# Multicast to all machines with a tag
tuntun send ./build.tar.gz tag:ci

# View pending offers
tuntun send list

# Accept or reject
tuntun send accept <transfer_id>
tuntun send reject <transfer_id>

# View history
tuntun send history

# Configure consent mode and inbox
tuntun send config
tuntun send config --consent prompt --inbox ~/TunTun/inbox

How it works

The sender offers a file (or directory) to the target peer(s). If the receiver's consent mode allows it, the transfer proceeds immediately. Otherwise, the offer appears as a pending transfer that the receiver must explicitly accept or reject.

Files land in ~/TunTun/inbox/ by default. Each file is transferred as an iroh-blob, so data integrity is cryptographically verified end-to-end with BLAKE3.

Node SDK

File transfer is also available from the Node SDK:

const node = await TunTunNode.create();
await node.sendFile("./data.csv", "api-server", "weekly export");