How I managed to set up Dropbox cloud sync with KOReader step by step

[pcgirl65]

Can this be setup in Calibre using the Koreader sync plugin?

[cocowash]

summary:
1.
create app> Scoped access > full Dropbox> give it a name
2.
Permissions> write and read for account_info, files.metadata and files.content
(Team permissions will require a business account and they are not necessary for our purpose)
3.
copy appkey and app secret

4.
copy appkey in the next link and click continue continue to get the AUTHORIZATION_CODE:

https://www.dropbox.com/oauth2/authorize?client_id=APPKEYHERE&response_type=code&token_access_type=offline

5.
copy AUTHORIZATION_CODE and APP_KEY:APP_SECRET and use a terminal:

curl.exe https://api.dropbox.com/oauth2/token -d code=AUTHORIZATION_CODE -d grant_type=authorization_code -u APP_KEY:APP_SECRET

6.
save refresh_token

7.
connect kindle an look in koreader/settings/cloudstorage.lua
save it.
(don't copy it by hand, it doesn't worth it)

["address"] = "app_key:app_secret",
            ["name"] = "app name",
            ["password"] = "refresh token",
            ["type"] = "dropbox",
            ["url"] = "",

[oldbear]

Tried it twice, but it doesn't work for me with my Kobo Clara BW (even if I guess it doesn't have anything to do with my kobo type).
Everything runs ok since I go to "Cloud storage" in KOReader and click on the appname for Dropbox. I always get the following message :

Cannot fetch list of folder contents. 
Please check your configuration or network connection.

I tried to add or to delete the "/" for Dropbox folder, but it doesn't change anything... and I triple checked the codes I pasted and it's OK.
Any idea ?

[Zann]

First of all, thank you so much OP for your tutorial, I was able to set everything up and it works well!

I was wondering if there is a way to set a favorite, a shortcut or a quick menu item to point to my dropbox storage? Or at least to the "Online Storage" menu?

[hius07]

Originally Posted by Zann

Or at least to the "Online Storage" menu?

Already in the nightly build.

[Zann]

Originally Posted by hius07

Already in the nightly build.

Hi, thanks for answering! The nightly build is like an alpha version of a future new release of KOReader, is that right? I just have to wait for it to get into the main release? Or is it a completely different build?

[hius07]

No need to wait, just install it, it's good.
https://build.koreader.rocks/downloa...84_2025-09-24/