# Magic Wormhole
[![PyPI](http://img.shields.io/pypi/v/magic-wormhole.svg)](https://pypi.python.org/pypi/magic-wormhole)
![Tests](https://github.com/magic-wormhole/magic-wormhole/workflows/Tests/badge.svg)
[![Windows Build Status](https://ci.appveyor.com/api/projects/status/w1bdniovwm4egfyg/branch/master?svg=true)](https://ci.appveyor.com/project/warner/magic-wormhole)
[![codecov.io](https://codecov.io/github/magic-wormhole/magic-wormhole/coverage.svg?branch=master)](https://codecov.io/github/magic-wormhole/magic-wormhole?branch=master)
[![Docs](https://readthedocs.org/projects/magic-wormhole/badge/?version=latest)](https://magic-wormhole.readthedocs.io)
[![Irc](https://img.shields.io/badge/irc.libera.chat-%23magic--wormhole-brightgreen)](https://web.libera.chat/)
[![Matrix](https://img.shields.io/badge/matrix.org-%23magic--wormhole-brightgreen)](https://matrix.to/#/#magic-wormhole:matrix.org)
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.
* PyCon 2016 presentation: [Slides](http://www.lothar.com/~warner/MagicWormhole-PyCon2016.pdf), [Video](https://youtu.be/oFrTqQw0_3c)
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](https://github.com/magic-wormhole/magic-wormhole-mailbox-server),
and the
[transit relay](https://github.com/magic-wormhole/magic-wormhole-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.8 and higher (tested against
versions up to 3.12).
## Packaging, Installation
Magic Wormhole packages are included in many operating systems.
[![Packaging status](https://repology.org/badge/vertical-allrepos/magic-wormhole.svg)](https://repology.org/project/magic-wormhole/versions)
To install it without an OS package, follow the [Installation docs](https://magic-wormhole.readthedocs.io/en/latest/welcome.html#installation).
Raw data
{
"_id": null,
"home_page": "https://github.com/warner/magic-wormhole",
"name": "magic-wormhole",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Brian Warner",
"author_email": "warner-magic-wormhole@lothar.com",
"download_url": "https://files.pythonhosted.org/packages/1b/a8/32a54e75643206665f569dac6ab19727aefb508b148882f1d05dff003667/magic_wormhole-0.17.0.tar.gz",
"platform": null,
"description": "# Magic Wormhole\n[![PyPI](http://img.shields.io/pypi/v/magic-wormhole.svg)](https://pypi.python.org/pypi/magic-wormhole)\n![Tests](https://github.com/magic-wormhole/magic-wormhole/workflows/Tests/badge.svg)\n[![Windows Build Status](https://ci.appveyor.com/api/projects/status/w1bdniovwm4egfyg/branch/master?svg=true)](https://ci.appveyor.com/project/warner/magic-wormhole)\n[![codecov.io](https://codecov.io/github/magic-wormhole/magic-wormhole/coverage.svg?branch=master)](https://codecov.io/github/magic-wormhole/magic-wormhole?branch=master)\n[![Docs](https://readthedocs.org/projects/magic-wormhole/badge/?version=latest)](https://magic-wormhole.readthedocs.io)\n[![Irc](https://img.shields.io/badge/irc.libera.chat-%23magic--wormhole-brightgreen)](https://web.libera.chat/)\n[![Matrix](https://img.shields.io/badge/matrix.org-%23magic--wormhole-brightgreen)](https://matrix.to/#/#magic-wormhole:matrix.org)\n\n\nGet things from one computer to another, safely.\n\nThis package provides a library and a command-line tool named `wormhole`,\nwhich makes it possible to get arbitrary-sized files and directories\n(or short pieces of text) from one computer to another. The two endpoints are\nidentified by using identical \"wormhole codes\": in general, the sending\nmachine generates and displays the code, which must then be typed into the\nreceiving machine.\n\nThe codes are short and human-pronounceable, using a phonetically-distinct\nwordlist. The receiving side offers tab-completion on the codewords, so\nusually only a few characters must be typed. Wormhole codes are single-use\nand do not need to be memorized.\n\n* PyCon 2016 presentation: [Slides](http://www.lothar.com/~warner/MagicWormhole-PyCon2016.pdf), [Video](https://youtu.be/oFrTqQw0_3c)\n\nFor complete documentation, please see https://magic-wormhole.readthedocs.io\nor the docs/ subdirectory.\n\nThis program uses two servers, whose source code is kept in separate\nrepositories: the\n[mailbox server](https://github.com/magic-wormhole/magic-wormhole-mailbox-server),\nand the\n[transit relay](https://github.com/magic-wormhole/magic-wormhole-transit-relay).\n\n## License, Compatibility\n\nMagic-Wormhole is released under the MIT license, see the `LICENSE` file for details.\n\nThis library is compatible with Python 3.8 and higher (tested against\nversions up to 3.12).\n\n## Packaging, Installation\n\nMagic Wormhole packages are included in many operating systems.\n\n[![Packaging status](https://repology.org/badge/vertical-allrepos/magic-wormhole.svg)](https://repology.org/project/magic-wormhole/versions)\n\nTo install it without an OS package, follow the [Installation docs](https://magic-wormhole.readthedocs.io/en/latest/welcome.html#installation).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Securely transfer data between computers",
"version": "0.17.0",
"project_urls": {
"Homepage": "https://github.com/warner/magic-wormhole"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "33fb1b99e37fc03bc279b5262a94a65b31ba033aa7449912485e1e085cb97e9f",
"md5": "11e287fe037aa133c075a1fc13d16931",
"sha256": "079e0e1f0e50b2515877edf5ac8335194135a6aa4f44cfb788330e08da91db38"
},
"downloads": -1,
"filename": "magic_wormhole-0.17.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "11e287fe037aa133c075a1fc13d16931",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 200750,
"upload_time": "2024-10-23T22:11:59",
"upload_time_iso_8601": "2024-10-23T22:11:59.575361Z",
"url": "https://files.pythonhosted.org/packages/33/fb/1b99e37fc03bc279b5262a94a65b31ba033aa7449912485e1e085cb97e9f/magic_wormhole-0.17.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1ba832a54e75643206665f569dac6ab19727aefb508b148882f1d05dff003667",
"md5": "61143e1480353de7b502d1b904837fb0",
"sha256": "142c7a271684b0b04470792601848f6b0ade0d8bf54fbcb30c6259d75edd9d06"
},
"downloads": -1,
"filename": "magic_wormhole-0.17.0.tar.gz",
"has_sig": false,
"md5_digest": "61143e1480353de7b502d1b904837fb0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 284056,
"upload_time": "2024-10-23T22:12:02",
"upload_time_iso_8601": "2024-10-23T22:12:02.531562Z",
"url": "https://files.pythonhosted.org/packages/1b/a8/32a54e75643206665f569dac6ab19727aefb508b148882f1d05dff003667/magic_wormhole-0.17.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-23 22:12:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "warner",
"github_project": "magic-wormhole",
"travis_ci": true,
"coveralls": true,
"github_actions": true,
"appveyor": true,
"tox": true,
"lcname": "magic-wormhole"
}