Magic Wormhole: Securely Transfer Files and Text Between Computers

Magic Wormhole: Securely Transfer Files and Text Between Computers

Summary

Magic Wormhole is an open-source tool that enables secure and easy transfer of files, directories, or text snippets between computers. It uses unique, human-pronounceable "wormhole codes" to identify endpoints, ensuring safe, one-time use transfers without complex setup. This Python-based utility simplifies cross-device data sharing with strong cryptographic guarantees.

Repository Info

Updated on December 12, 2025
View on GitHub

Tags

PythonFile TransferSecurityP2PCLI ToolOpen SourceData Sharing

Click on any tag to explore related repositories

Introduction

Magic Wormhole is an innovative open-source tool designed to facilitate the secure and straightforward transfer of files, directories, and short pieces of text between computers. Developed by the magic-wormhole organization, this Python-based utility simplifies the often-complex process of moving data across different machines. It achieves this by using unique, human-pronounceable "wormhole codes" that act as a shared secret between the sending and receiving endpoints, ensuring that only the intended parties can access the data. Each wormhole code is single-use, enhancing security and privacy.

Installation

Magic Wormhole is widely available and can be installed through various operating system package managers. For detailed instructions or to install it without an OS package, refer to the official documentation. The project is compatible with Python 3.10 and higher.

# Example for pip installation (refer to docs for recommended method)
pip install magic-wormhole

For comprehensive installation guides, please visit the Installation documentation.

Examples

Using Magic Wormhole is intuitive. The sending machine generates a wormhole code, which is then typed into the receiving machine. For instance, to send a file:

On the sending machine:

wormhole send my_document.pdf

This command will output a wormhole code, such as "4-purple-dragon".

On the receiving machine:

wormhole receive 4-purple-dragon

Upon entering the correct code, the file transfer will commence securely. You can also send text or entire directories with similar commands.

Why Use It

Magic Wormhole stands out for its emphasis on security and user-friendliness. The human-pronounceable, single-use codes eliminate the need for complex key exchanges or server configurations, making secure transfers accessible to everyone. Its cryptographic design ensures that data is transferred safely, protecting it from eavesdropping. Whether you need to quickly share a document with a colleague or move files between your own devices, Magic Wormhole provides a robust, efficient, and secure solution.

Links