p403n1x87 / erwin

Erwin likes putting stuff in boxes. He's simultaneously useless and useful until you try him.

Meet Erwin

Erwin likes to put stuff in boxes for safekeeping and synchronisation across devices, using Google Drive as cloud storage service. He's both useless and useful, until you try him for the first time :).

Synopsis • Installation • Usage • Why Erwin • Compatibility • Contribute

Synopsis

⚠️ WARNING Erwin is still in beta and not extensively tested. Whilst your remote files are pretty safe, it cannot be completely excluded at the moment that local files won't be lost. Use at your own risk, and if you do, please always make backup copies of important files first!

Erwin is a cloud storage synchronisation service. Currently, it works with Google Drive and allows you to have a local mirror copy of the files stored on your Google Drive account.

There are some known restrictions at the moment. There is no support for Google Docs, which means that you won't see these files in your local copy. Furthermore, Google Drive allows for multiple files to have the same name within the same directory. Most local file systems don't allow for a similar thing, so Erwin will work as expected for you only if you make sure never to use the same name for files within the same folder.

Installation

Erwin can be installed directly from GitHub with

pip install git+https://github.com/P403n1x87/erwin

Usage

Once installed, Erwin can be launched with

erwin

On the first boot, you will be prompted to enter some configuration, like an alias for your account, and the path where you want the files to be synchronised locally (e.g. /home/gabriele/GoogleDrive).

It is recommended to wrap Erwin around a systemd (user) service for easy control and automatic startup on login (see, e.g., https://wiki.archlinux.org/index.php/Systemd/User for details).

Why Erwin

Erwin is similar to other Google Drive solutions like google-drive-ocamlfuse, the main difference being that it behaves more like services such as Dropbox. Files are synchronised from the remote cloud storage to the local file system. This means that your files will be available even when you are offline. Any changes are pushed and pulled as soon as they are available and your system is connected to the public network.

Compatibility

Erwin has been tested with Python 3.6 on Ubuntu 18.04.

Contribute

Any help with improving Erwin is very welcome :).

erwin's Issues

Increase performance by batching requests

Description

Many small requests should be batched (e.g. file deletions) in order to increase performance.