open.source/magic-wormhole
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
get things from one computer to another, safely
1,458 Commits 1 Branch 0 Tags 2.9 MiB
Python 95.4%
JavaScript 4.3%
CSS 0.1%
c068bfdfdd
Go to file
Brian Warner c068bfdfdd transit key is derived from the wrong APPID, bummer 
When I made it possible to override APPID with a CLI argument (issue #113), I
forgot to also change this w.derive_key() (issue #339). We don't really need
to include APPID in that purpose string at all (the ideal code would be just
`w.derive_key("transit-key", length)`), but we're stuck with it now. Both
sides must use the same derivation process, and it would be pretty
expensive/complicated to negotiate the process ahead of time (and this code
is scheduled to be obsoleted by Dilation anyways).

I added a note to the two sites that use it, and put a local copy of the
APPID there. We should treat that copy as an arbitrary magic string that must
be included for compatibility with existing deployments (potential
file-transfer peers), which is coincidentally similar to the default `APPID`.

closes #339
2019-07-24 11:11:48 -07:00
docs docs: add dilation state machines diagram 2019-07-05 15:56:13 -07:00
misc remove server-related source files, munin plugins 2018-02-20 23:46:29 -08:00
pyi use pyinstaller to build wormhole fat/standalone binary 2018-06-02 18:05:45 +02:00
src/wormhole transit key is derived from the wrong APPID, bummer 2019-07-24 11:11:48 -07:00
.appveyor.yml appveyor: set TOXENV separately for each python version 2019-05-05 19:22:06 -04: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 use pyinstaller to build wormhole fat/standalone binary 2018-06-02 18:05:45 +02:00
.travis.yml README: drop python3.4 support 2019-07-05 15:50:00 -07:00
LICENSE Initial commit 2015-02-10 00:38:44 -08:00
MANIFEST.in MANIFEST.in: add some missing files 2018-10-16 16:29:24 -07:00
NEWS.md NEWS: update for 0.11.2 release 2018-11-13 15:08:53 -08:00
README.md README: drop python3.4 support 2019-07-05 15:50:00 -07:00
setup.cfg setup.cfg: bump flake8 max-line-length to 85 2018-12-23 15:22:57 -05:00
setup.py setup.py: hush deprecation warning 2019-02-10 11:18:48 -08:00
snapcraft.yaml Merge PR237 2017-07-31 12:29:21 -07:00
tox.ini add 'tox -e docs', travis job to exercise it 2019-05-05 18:02:00 -04:00
versioneer.py Correct spelling mistakes 2018-11-23 07:38:21 +00:00

README.md

Magic Wormhole

PyPI Build Status Windows Build Status codecov.io 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 https://magic-wormhole.readthedocs.io or the docs/ subdirectory.

License, Compatibility

This library is released under the MIT license, see LICENSE for details.

This library is compatible with python2.7, 3.5, 3.6, and 3.7.