get things from one computer to another, safely https://magic-wormhole.readthedocs.io/en/latest/
Find a file
2025-12-30 22:24:15 +00:00
.github/workflows add python 3.14 testing 2025-10-08 10:39:35 -06:00
docs update link to wormhole flutter 2025-12-16 17:59:58 +01:00
misc style: update syntax to recent Python versions 2025-07-14 16:10:52 +02:00
pyi trim trailing whitespace 2021-08-25 19:19:52 +00:00
signatures signatures for release 2025-10-30 11:36:37 -06:00
src/wormhole show env-vars in --help output 2025-12-09 15:12:18 -07:00
.appveyor.yml remove python2.7 support 2022-10-27 05:57:18 +02:00
.coveragerc add 'coverage' environment for tox 2016-05-24 16:03:39 -07:00
.gitattributes initial setup.py, versioneer-ification 2015-02-10 00:48:19 -08:00
.gitignore add .hypothesis and ignore automat in any dir 2025-04-09 14:14:34 -04:00
.readthedocs.yaml read-the-docs configuration 2024-10-23 16:17:30 -06:00
bash-completions-version-4.patch properly patch bash for MacOS, as well as in the future 2025-08-01 14:42:08 -06:00
LICENSE Initial commit 2015-02-10 00:38:44 -08:00
Makefile resume normal releases 2025-10-30 11:37:01 -06:00
MANIFEST.in MANIFEST.in: add some missing files 2018-10-16 16:29:24 -07:00
newest-version.py formatting / flake8 2023-08-12 00:18:20 -06:00
NEWS.md update NEWS 2025-12-30 15:16:32 -07:00
pyproject.toml drop pytest -s/--capture=no arg 2025-07-06 23:37:28 +02:00
README.md doc: update minimal Python version required 2025-06-04 18:39:03 +02:00
setup.cfg Ignore assertIn (case specific) 2024-05-24 15:31:05 -04:00
setup.py blacklist more non-working Autobahns 2025-12-30 15:13:30 -07:00
snapcraft.yaml Merge PR237 2017-07-31 12:29:21 -07:00
tox.ini pyflakes cleanups 2025-06-03 02:39:52 -06:00
update-version.py use updated dulwich with pysequoia 2025-10-23 23:50:32 -06:00
versioneer.py style: update syntax to recent Python versions 2025-07-14 16:10:52 +02:00
wormhole_complete.bash properly patch bash for MacOS, as well as in the future 2025-08-01 14:42:08 -06:00
wormhole_complete.fish update completions 2025-12-30 15:14:19 -07:00
wormhole_complete.zsh update completions 2025-12-30 15:14:19 -07:00

Magic Wormhole

PyPI Tests Windows Build Status codecov.io Docs Irc Matrix

Get things from one computer to another, safely.

This package provides a library and a command-line tool named wormhole, which makes it possible to get arbitrary-sized files and directories (or short pieces of text) from one computer to another. The two endpoints are identified by using identical "wormhole codes": in general, the sending machine generates and displays the code, which must then be typed into the receiving machine.

The codes are short and human-pronounceable, using a phonetically-distinct wordlist. The receiving side offers tab-completion on the codewords, so usually only a few characters must be typed. Wormhole codes are single-use and do not need to be memorized.

For complete documentation, please see https://magic-wormhole.readthedocs.io or the docs/ subdirectory.

This program uses two servers, whose source code is kept in separate repositories: the mailbox server, and the transit relay.

License, Compatibility

Magic-Wormhole is released under the MIT license, see the LICENSE file for details.

This library is compatible with Python 3.10 and higher (tested against versions up to 3.12).

Packaging, Installation

Magic Wormhole packages are included in many operating systems.

Packaging status

To install it without an OS package, follow the Installation docs.