lansync

Make file sharing easier


License
MIT
Install
pip install lansync==0.0.1

Documentation

Sales pitch

- Ever felt the pain of transferring files to your peers?

- Yeah, well we've got Facebook and email to transfer them.

- What if you file is bigger than 25MB? What if you want to transfer a 10GB archive or a VM image?

Not everyone has big USB sticks or external hard drives with them all the time. Online file sharing services are cool, however, there are 2 things I dislike about them:

  1. Sending any file to a peer means uploading it on a server first and then my peer has to download it which is a total waste of traffic. What if my bandwidth is low?
  2. Privacy concerns - I don't want someone potentially snooping on my files.

Peer-to-peer should be easy, especially when connected to the same network! How do we do it then?

Read on.

What is this project about?

lansync is an application that simplifies file transfers between peers connected to the same network.

It is a wrapper around the popular rsync tool. The way rsync works is really clever and it's quite easy to synchronize files on different machines.

The issue is that 99% of the time rsync is used with ssh and having ssh access to someone's computer is not desirable (at least from their point of view).

Fortunately, you can use rsync with ssh by severely limiting the access you have over that channel. To be more precise you are allowed only to run rsync --server on the receiving side.

Demo

Here you can see a simple example. The client on the left wants to send test.txt to the client on the left. You can see that both machines have different ip addresses but are on the same network. Before running lansync the rsync command fails dues to missing permissions, but once the public key of the machine on the right is imported, rsync succeeds and the file is successfully sent.

Currently key importing can be done in several ways with -i or --import:

  • Raw string of passed
  • Read from a file
  • Github username

Note that for each of the last two, if multiple keys are found, they will all be added.

Now since you are importing other people's (hopefully ones you trust) keys it would be a good idea to limit the share directory in some way. You don't want people trolling you by sending 100GB files just do troll you and leave with without any free space.

Share size limit

How does it work?

When you run lansync --size <some size> a file is created with that size on your machine in the ~/.lansync/ directory. Afterwards that file is formatted as a disk image and a single ext4 partition is setup.

Mounting filesystems requires sudo access so it has been left up to you to mount the new filesystem in you share directory. The application tells you how to do that exactly in a secure way.

Essentially, people are sharing files to your virtual filesystem that you can delete anytime you want without affecting the rest of your system.

Installation

Currently I do no provide a single binary so I recommend installing dependencies in a virtual environment:

$ git clone git@github.com:ViktorBarzin/lansync.git
$ pip install -r requirements.txt

See help with

$ python lansync.py -h

TODO:

  • add PyPi package/binary
  • smb support

Known issues

  • Since the app is composed of multiple files, moving any of them to another directory may result if failure to run. (Paths are painful)