warner/magic-wormhole
Magic Wormhole
Magic-wormhole is a peer-to-peer file transfer tool used to send files, directories, and text strings between computers. It functions as a secure data relay that establishes ephemeral encrypted network tunnels for ad hoc data exchange without requiring permanent accounts or shared folders.
The system utilizes a password-authenticated key exchange to establish a shared secret from a short, human-readable code. This single-use secret handshake ensures the connection is invalidated after a successful pair to prevent replay attacks, while a rendezvous server helps peers exchange connection details to bypass firewalls.
The tool provides a command-line interface for performing point-to-point transfers using end-to-end AES encryption. It manages large data transfers through chunked data streaming and TCP-based peer tunneling to move information safely between devices.
Features
- Peer-to-Peer File Sharing - Acts as a peer-to-peer utility for sending files and text between computers using single-use encryption codes.
- Secure File Transfer - Provides secure transfer of arbitrary sized files, directories, and text strings between computers.
- Ad Hoc Data Exchange - Enables quick sending of text or files between machines without requiring permanent accounts or shared folders.
- Encrypted Tunneling - Establishes temporary encrypted tunnels between two endpoints for safe information exchange.
- Single-Use Handshakes - Ensures the connection code is invalidated immediately after a successful pair to prevent replay attacks.
- Password-Authenticated Key Exchanges - Uses a password-authenticated key exchange to establish a shared secret from a human-readable code.
- End-to-End Encryption - Provides end-to-end AES encryption to ensure only the intended recipients can access the transferred data.
- PAKE Transports - Implements a transport mechanism using PAKE to establish encrypted connections without pre-shared keys.
- Command Line Interfaces - Provides a terminal-based interface for performing secure point-to-point transfers.
- File Sharing - Facilitates direct file sharing between different hardware devices over a network.
- Network Data Streaming - Uses chunked data streaming to move large files efficiently between network sockets and disks.
- Encrypted Relaying - Uses a rendezvous server as an encrypted relay to move data between hosts and bypass firewalls.
- Peer-to-Peer Networking - Establishes direct TCP-based peer-to-peer network connections for streaming data without permanent intermediaries.
- Rendezvous Servers - Implements a rendezvous server to help peers exchange connection details and bypass firewalls.
- Communication and Collaboration - Secure and fast file transfer tool for text and directories.
- File Sharing - Secure transfer of files and text between computers.
