Developers

Developer documentation

Details of all command line tools

jottafuse

How to set up

Remember to get this package:

pip install jottacloudclient[FUSE]

How it works

jottacloudclientscanner

A cli friendly sync client for JottaCloud.

It will sync your directory tree with JottaCloud, just like the official client does.

Run jottacloudclientscanner.py at some interval:

python jottacloudclientscanner.py <top dir of your local tree> <the mount point on jottacloud>

The top dir is just an existing directory on your system that you want to backup.

The mount point is a path on JottaCloud. It's put together from a combination of an existing device name, an existing backupdir and a folder name (that will be created if it doesn't exist). Like this: /<devicename>/<backupdir>/<foldername>

Example:

python jottacloudclientscanner.py /mnt/pictures /mybox/backup/pictures

How to set up

Remember to get this package:

pip install jottacloudclient[scanner]

How it works

The basic operation on the JottaCloud servers is to make file level backups. Unlike data-level protocols like rsync, the JottaCloud protocol does not seem to support delta encoding, so file syncing needs to happen by copying the full file content.

To determine if a file needs to be updated, Jotta Cloud Client will compare the md5 hash of the local file with the one that the JottaCloud server reports. If the hashes differ, the client will upload the file. This is akin to how the official JottaCloud client works.

Fine-tuning to your needs

There are several ways where you can adapt this tool to your setup. Let's look at how.

Local checksum cache

Install

--no-checksum

jottacludclientmonitor

TBD

How to set up

Remember to get this package:

pip install jottacloudclient[monitor]

How it works

TBD

The Jottalib API

A lot of words to describe spirit and method, and a link to the docs

QT models

The project aims to supply a fully-functional QStandardItemModel for easy pyqt4 programming.

Take a look at jottalib.qt, where you'll find a JFSModel(QtGui.QStandardItemModel) class and various JFSNode(QtGui.QStandardItem) classes to match the jottacloud api. Using these classes you'll hopefully be able to focus on the UI/UX and leave the plumbing to jottalib.

Note! By default, the pyqt is an optional dependency. You have to install it explicitly:

pip install jottalib[Qt]

The Jottacloud protocol explained

But it's not finished!

But it's not very advanced!

Geez, you should've added super bright idea already!

Want to help out? Great! You have several options to get started.

1. Look for low hanging fruit in the reported issues.
2. As about in the dev channel to figure out where to begin
3. Flesh out details on what you miss in a new bug report
4. Fork the code and add the features you miss. Then, submit a pull request and smile! You're contributing to the world!