Code Monkey home page Code Monkey logo

kobocloud's Introduction

KoboCloud

A set of scripts to synchronize a kobo reader with popular cloud services.

The following cloud services are supported:

  • Dropbox
  • Google Drive
  • NextCloud/OwnCloud
  • pCloud

Installation

The installation process has 2 steps:

  • Compile the script into an archive format
  • Install into the Kobo device

Below we describe each step.

Compilling

  • Move to the project directory root
  • Open the configuration file located at src/usr/local/kobocloud/kobocloudrc.tmpl
  • Add the links to the cloud services (see the configuration example that follow below)
  • Run sh ./makeKoboRoot.sh

The last command will create a KoboRoot.tgz archive.

Installing

  • Connect the Kobo device and mount it (you should be able to access to the kobo filesystem)
  • Copy the .tgz archive in the .kobo directory(1) of your device
  • Restart your Kobo device

(1) It is a hidden directory, so you have to enable the visualization of hidden files

Configuration

After following the installation process:

  • Plug your Kobo back into the computer
  • Open the configuration file located at .add/kobocloud/kobocloudrc
  • Add the links to the cloud services (one per line)

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

Important: make sure that there are no spaces before or after the link on the line.

Notice: No subdirectories are supported at the moment. Your books must be all in the same directories that you are sharing.

Restart your Kobo after making changes to kobocloudrc to make them effective.

Dropbox

To add a Dropbox link:

  • Open your dropbox in a browser
  • Select the folder that you want to share and click "Share" and "Send link"
  • Copy the link that appears into the kobocloudrc file

Google Drive

  • Use the "link sharing" option on a Google Drive folder
  • Select the option "anyone with the link can view."
  • Copy-paste the link in the kobocloudrc file

Important: Folders with many files might not work.

Nextcloud (Owncloud)

To add a NextCloud (ownCloud) link:

  • Open your nextcloud website in a browser
  • Select the folder that you want to share
  • Click on "Share" and select "Share with link"
  • Copy the link into the kobocloudrc file

Please note that you need a recent Nextcloud version. Owncloud is at the moment not tested, but should also work.

pCloud

Files added into a subfolder of the public folder of pCloud are also supported.

Usage

The new files will be downloaded when the kobo connects to the Internet for a sync.

Uninstallation

To properly uninstall KoboCloud:

  • Edit the kobocloudrc file so that it contains the word UNINSTALL in a single line (all capital, no spaces before or after)
  • Restart your Kobo

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.

Troubleshooting

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.

Known issues

  • No subdirectories are supported
  • Some versions of Kobo make the same book appear twice in the library. This is because it scans the internal directory where the files are saved as well as the "official" folders. To solve this problem find the Kobo eReader.conf file inside your .add folder and make sure the following line (which prevents the syncing of dotfiles and dotfolders) is set in the [FeatureSettings] section:
  ExcludeSyncFolders=\\.(?!add|adobe).*?

Acknowledgment

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.

kobocloud's People

Contributors

fsantini avatar desyncr avatar wzzza avatar kjeldahl avatar

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.