31 breaking releases
| 0.34.0 | May 8, 2026 |
|---|---|
| 0.32.0 | Mar 17, 2026 |
| 0.31.0 | Nov 6, 2025 |
| 0.27.0 | Jul 31, 2025 |
| 0.2.2 | Dec 21, 2023 |
#778 in Network programming
63 downloads per month
54KB
999 lines
Sendme
This is an example application using iroh with the iroh-blobs protocol to send files and directories over the internet.
It is also useful as a standalone tool for quick copy jobs.
Iroh will take care of hole punching and NAT traversal whenever possible, and fall back to a relay if hole punching does not succeed.
Iroh-blobs will take care of blake3 verified streaming, including resuming interrupted downloads.
Sendme works with 256 bit node ids and is, therefore, location transparent. A ticket will remain valid if the IP address changes. Connections are encrypted using TLS.
Installation
cargo install sendme
Usage
Send side
sendme send <file or directory>
This will create a temporary iroh node that serves the content in the given file or directory. It will output a ticket that can be used to get the data.
The provider will run until it is terminated using Control-C. On termination, it
will delete the temporary directory.
This currently will create a temporary directory in the current directory. In the future this won't be needed anymore.
Receive side
sendme receive <ticket>
This will download the data and create a file or directory named like the source in the current directory.
It will create a temporary directory in the current directory, download the data (single file or directory), and only then move these files to the target directory.
On completion, it will delete the temp directory.
All temp directories start with .sendme-.
License
Copyright 2026 N0, INC.
This project is licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Dependencies
~54–99MB
~1.5M SLoC