A set of scripts to synchronize a kobo reader with popular cloud services.
The following cloud services are supported:
Download the latest KoboRoot.tgz
from the Release page (or using this direct link).
Copy it into the Kobo device:
(1) It is a hidden directory, so you have to enable the visualization of hidden files
Note for Mac/Safari users: Safari automatically unpacks KoboRoot.tgz
into KoboRoot.tar
after downloading. Please make sure that you transfer the .tgz
file to your Kobo, and not the .tar
. Either use a different browser to download the package, or re-pack it (using gzip
) before transferring.
After the installation process:
.add/kobocloud/kobocloudrc
Configuration example:
# Lines starting with '#' are ignored
# Google drive:
https://drive.google.com/drive/folders/<ID>?usp=sharing
# Dropbox:
https://www.dropbox.com/sh/pgSHORTENED
REMOVE_DELETED
Some important advice:
Due to a change in Dropbox website, the public folder method does not work anymore.
This method will create a folder /Applications/Kobo Cloud Sync
in your Dropbox and sync with it.
DropboxApp:
from your terminalkobocloudrc
fileSubdirectories are supported for Google Drive. Important: Folders with many files might not work.
To add a NextCloud (ownCloud) link:
Please note that you need a recent NextCloud (OwnCloud) version. Subdirectories are supported for NextCloud (OwnCloud).
Important: Webdav for public folders should be enabled, see: https://docs.nextcloud.com/server/20/user_manual/en/files/access_webdav.html#accessing-public-shares-over-webdav for more info.
Files added into a subfolder of the public folder of pCloud are also supported.
Due to a different download method for pCloud (new share links have a different format) subfolders are only supported on the older share folders. Not on the newer ones.
Please note that, even though the script supports folders where the file list has multiple pages, having a list with many pages might not work.
To delete files from library when they are no longer in the remote server:
REMOVE_DELETED
in a single line (all capital, no spaces before or after).The next time the Kobo is connected to the internet, it will delete any files (it will not delete directories) that are not in the remote server.
The new files will be downloaded when the kobo connects to the Internet for a sync. Sometimes few minutes is needed after the sync process for the device to recognize and import new downloaded content.
To properly uninstall KoboCloud:
UNINSTALL
in a single line (all capital, no spaces before or after)The next time the Kobo is connected to the Internet, the program will delete itself.
Note: The directory .add/kobocloud will not be deleted: after connecting the device to a computer, you should move the files from the Library subfolder in order not to lose your content, and delete the whole kobocloud directory manually.
To install KoboCloud from source code:
src/usr/local/kobocloud/kobocloudrc.tmpl
sh ./makeKoboRoot.sh
The last command will create a KoboRoot.tgz
archive.
Now you can follow installation instructions.
KoboCloud keeps a log of each session in the .add/kobocloud/get.log file. If something goes wrong, useful information can be found there. Please send a copy of this file with every bug report.
Kobo eReader.conf
file inside your .kobo/Kobo
folder and make sure the following line (which prevents the syncing of dotfiles and dotfolders) is set in the [FeatureSettings]
section:
ExcludeSyncFolders=\\.(?!add|adobe).*?
KoboCloud installs NickelDBus if not present. Thanks to shermp for providing this! Thanks to the defunct SendToKobo service for the inspiration of the project and for the basis of the scripts. Curl for Kobo was downloaded from here: https://www.mobileread.com/forums/showthread.php?p=3734553 . Thanks to NiLuJe for providing it! Thanks to Christoph Burschka for the help in updating this tool to the recent versions of kobo and nextcloud.