A simple, Zeroconf-based, peer to peer file transfer utility, for situations where you and your peer are sitting next to each other and want to transfer a file quickly (and can shout the filename across the room).
Files and peers are recognized by the filename they want to transfer, not by their hostnames or IPs.
zget uses the fact that the filename is known to both parties as a basic authentication feature: The sender only advertises the sha1 hash of the filename on the network. Since the receiver must also know the filename, it can look for the sha1 using zeroconf.
If a match was found, a simple HTTP request is made: For transferring the file the actual filename is then requested from the sender. If this filename wasn't correct, the process is aborted.
$ pip install zget
zget works both ways:
zputfor sharing a file
To share some pictures do:
$ zput my_holiday_pictures.zip
Hey Tom, I am sending you my_holiday_pictures.zip!
Tom will then do
$ zget my_holiday_pictures.zip
You want to have some very important data from Tom:
$ zget annual_reports.xlsx
Hey Tom, can you send me annual_reports.xlsx?
Tom then does
$ zput annual_reports.xlsx
Alternatively, in case of really complicated filenames, you can use aliases or
zput generate one for you:
$ zput LICENSE Download this file using `zget LICENSE` or `zget C6P3`
zget can generate an alias so you can initiate the transfer without knowing
what file will be transferred.
$ zget Upload a file using `zput <filename> YHKC`
As of version 0.10
zget will figure out the resulting filename from the transfer metadata, so you won't be stuck with a file
YHKC on your computer.
You may inspect the available options using
$ zput -h
$ zget -h
By default zget uses a random open port and the sending party must be able to accept incoming connections. This may be a problem when you have restrictive firewall settings or multiple network cards.
You may create a config file
to permanently set the port number and/or interface zget uses, e.g.
[DEFAULT] port = 8080 interface = eth0
Note that port numbers below 1024 may require root permissions to be opened.
As of zget 0.8, there exists a Python interface for sending and receiving files as function calls. E.g.:
import zget zget.put("filename", port=2200)
and for receiving:
import zget zget.get("filename", "filename_to_save_to")
For more information please see the API reference.
Neither Zeroconf nor HTTP, both technologies used in this tool, should be used on untrusted networks (like public WiFi at a coffee shop).
zput announces the filename and aliases as a simple unsalted
SHA-1 hash on the network. This means that a malicious party could trivially
intercept your transfers by simply generating a large enough number of hashes
and then accepting the transfer on behalf of the desired recipient.
In this case you should however notice the attack by the recipient never receiving a file while the sender sees an upload happening.