6 releases (3 breaking)

0.6.1 Dec 4, 2023
0.6.0 Dec 21, 2022
0.5.0 May 25, 2022
0.4.0 Mar 23, 2022
0.0.1 Dec 21, 2018

#234 in Network programming

Download history 12/week @ 2023-12-18 115/week @ 2023-12-25 87/week @ 2024-01-01 33/week @ 2024-01-08 53/week @ 2024-01-15 63/week @ 2024-01-22 65/week @ 2024-01-29 53/week @ 2024-02-05 239/week @ 2024-02-12 445/week @ 2024-02-19 438/week @ 2024-02-26 455/week @ 2024-03-04 203/week @ 2024-03-11 204/week @ 2024-03-18 185/week @ 2024-03-25 172/week @ 2024-04-01

820 downloads per month
Used in 2 crates

EUPL-1.2

1MB
6K SLoC

Rusty Wormhole

Get things from one computer to another, safely.

http://magic-wormhole.io/

This is a Rust port of the Python version at https://github.com/magic-wormhole/magic-wormhole.

Comparison with the Python implementation

Features that are missing:

  • Tab completion
  • Text message sending
  • Folder sending (we can send folders, but it will send a tar ball which the other side will have to manually unpack)
  • Tor support

New features that exceed the other implementations:

  • Can do direct connections across the internet (NATs) and firewalls
  • Automatically copies your code to the clipboard
  • Port forwarding in addition to file transfer (experimental)
  • Send a file to multiple people (experimental)

Getting started

If you want to toy with the CLI, cargo run -- --help will get you started. The code sits in ./cli/src/bin.

If you'd like to use Wormhole in your application, cargo doc --open will tell you how to use it. There aren't any hosted docs at the moment.

If you don't fear touching code and want to contribute, ./src/lib.rs, ./src/transfer.rs and ./src/transit.rs are rather easy to get into. The protocol specification will probably be useful to you.

Applications using Wormhole Rust as library

  • Warp, a GUI client using Gtk

(feel free to add yours)

License

This work is licensed under the EUPL v1.2 or later. Contact the owner(s) for use in proprietary software.


Matrix Irc Build Status Deps Codecov Is-It-Maintained-Resolution-Time Crates.io Docs.rs

Dependencies

~19–33MB
~639K SLoC