You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Brian Warner d517a10282 README: update appveyor badge URL 2 weeks ago
.github/workflows add GitHub Actions -based CI 2 weeks ago
docs Fix link to rendezvous server repo in API doc 4 months ago
misc remove server-related source files, munin plugins 2 years ago
pyi use pyinstaller to build wormhole fat/standalone binary 2 years ago
src/wormhole test_cli: ignore deprecation noise for py2.7/py3.5 so tests won't fail 2 weeks ago
.appveyor.yml appveyor: set TOXENV separately for each python version 1 year ago
.coveragerc add 'coverage' environment for tox 4 years ago
.gitattributes initial, versioneer-ification 6 years ago
.gitignore use pyinstaller to build wormhole fat/standalone binary 2 years ago
.travis.yml tox/travis: test py3.8 too 9 months ago
LICENSE Initial commit 6 years ago add some missing files 2 years ago NEWS: update for 0.12.0 release 9 months ago README: update appveyor badge URL 2 weeks ago
setup.cfg setup.cfg: bump flake8 max-line-length to 85 2 years ago Replace deprecated attrs `cmp=False` parameter with `eq=False` (#384) 9 months ago
snapcraft.yaml Merge PR237 3 years ago
tox.ini tox/travis: test py3.8 too 9 months ago Correct spelling mistakes 2 years ago

Magic Wormhole

PyPI Tests Windows Build Status Docs

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 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.6 and higher (tested against 3.6, 3.7, 3.8, and 3.9). It also still works with Python 2.7 and 3.5, although these are no longer supported by upstream libraries like Cryptography, so it may stop working at any time.

Packaging, Installation

Magic Wormhole packages are included in many operating systems.

Packaging status

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