Getting Started

Install Dependencies

• Python 2.7
• pip

$ curl https://bootstrap.pypa.io/get-pip.py | sudo python

• virtualenv

$ pip install --user virtualenv

Install KoDrive

To set kodrive as a local command:

$ curl https://raw.githubusercontent.com/Jvlythical/KoDrive/master/static/get-kodrive.py | python

Initialize the KoDrive Daemon

$ kodrive sys start

Receiving Directories

1. Provide the other person with your system key:

$ kodrive sys key 

2. The person sharing their directory will then provide a directory key to link with:

CAUTION: linking will merge the 2 directories and grant access to everything in BOTH directories. This can lead to the sharing of sensitive data as well as conflicts. It is recommended for a receiver to link while in an empty directory. See conflicts for more information.

$ kodrive link <DIRECTORY-KEY>

Sharing Directories

1. The other user needs to be authorized (via their system key) to receive the directory:

$ kodrive auth <SYSTEM-KEY> 

2. Then obtain and provide the below directory key back to the other user:

$ kodrive dir key <PATH>

Figure 1. An illustration of the above process.

Stopping Synchronization

The sharer can deauthorize access to certain users:

kodrive auth -R <RECEIVER-SYSTEM-KEY> --path <PATH> deauthorizes a certain receiver from a directory. (-R for --remove)

Furthermore, the sharer can completely remove the directory from the daemon which will deauthorize all devices from that directory:

$ kodrive dir free <PATH>

The receiver(s) can only kodrive dir free <PATH> since it is not their directory. They are not allowed to kodrive dir auth -a/-R since they are not the sharer:

$ kodrive dir free <PATH>