English | 中文
Sendmer is a small CLI and reusable Rust library for sending files and directories over the internet with iroh and iroh-blobs.
It is based on n0-computer/sendme v0.31.0, with a codebase that has been gradually reorganized into a clearer library + CLI structure.
- Send a file or an entire directory with a single command
- NAT traversal and hole punching via iroh, with relay fallback when needed
- Verified streaming with blake3 through
iroh-blobs - Reusable Rust API via exported
sendandreceivefunctions - Optional CLI progress output and clipboard helper
sendmer uses 256-bit node IDs, so tickets remain valid even if IP addresses change during a session. Connections are encrypted with TLS.
# Install latest release
iwr https://raw.githubusercontent.com/bruceblink/sendmer/main/install.ps1 -useb | iex
# Or install a specific version
$env:SENDMER_VERSION="v0.4.3"
iwr https://raw.githubusercontent.com/bruceblink/sendmer/main/install.ps1 -useb | iexDefault install path:
C:\Users\<username>\.sendmer\bin\sendmer.exeAfter installation:
- Add
$InstallDirtoPATHif needed - Restart your terminal
- Run
sendmer --help
# Install latest release
curl -fsSL https://raw.githubusercontent.com/bruceblink/sendmer/main/install.sh | bash
# Or install a specific version
SENDMER_VERSION=v0.4.3 \
curl -fsSL https://raw.githubusercontent.com/bruceblink/sendmer/main/install.sh | bashDefault install path:
~/.sendmer/bin/sendmerIf needed, add it to your shell profile:
export PATH="$HOME/.sendmer/bin:$PATH"Then verify:
sendmer --helpcargo install sendmer --lockedsendmer send <file-or-directory>This starts a temporary iroh provider, imports the selected file or directory, and prints a receive command with a ticket.
Example:
sendmer send ./my-folderTypical output:
imported directory my-folder, 12.3 MiB, hash <hash>
to get this data, use
sendmer receive blob:...
The sender keeps running until you stop it with Ctrl+C. When it stops, it shuts down the temporary provider and removes its temporary blob store under the system temp directory.
sendmer receive <ticket>This downloads the data and writes it into the current working directory by default.
Use --output-dir <path> to choose a different destination.
Example:
sendmer receive <ticket>Receive-side data is staged in a temporary directory under the system temp directory and cleaned up after completion.
Common options are available on both send and receive:
--no-progress: disable CLI progress output-v/-vv: increase log verbosity--relay <default|disabled|url>: control relay usage--magic-ipv4-addr <addr>: bind a fixed IPv4 address--magic-ipv6-addr <addr>: bind a fixed IPv6 address--show-secret: print the secret key used for the current process
Receive-specific options:
--output-dir <path>: set where received files are written (default: current working directory)
Send-specific options:
--ticket-type <id|relay-and-addresses|relay|addresses>: control how much addressing information is embedded in the ticket--format <hex|cid>: choose how the imported hash is printed--clipboard: copy the generatedsendmer receive ...command to the clipboard
The crate also exposes a small library API:
use sendmer::{receive, send, ReceiveOptions, SendOptions};
#[tokio::main]
async fn main() -> anyhow::Result<()> {
// let send_result = send(path, SendOptions::default(), None).await?;
// let receive_result = receive(ticket, ReceiveOptions::default(), None).await?;
Ok(())
}The library re-exports:
- argument and option types
- transfer event types and
EventEmitter sendandreceiveSendResultandReceiveResult
