Dropbox Sync for KOReader

A KOReader plugin that provides one-click synchronization between your Kindle's home directory and a Dropbox folder. Files in Dropbox that aren't on your Kindle will be downloaded, and files on your Kindle that aren't in Dropbox will be uploaded.

Features

• One-click sync - No complex menus, just tap and sync
• Uses existing Dropbox config - Reuses your Cloud Storage Dropbox configuration
• Two-way sync - Downloads new files from Dropbox, uploads new local files to Dropbox
• WiFi aware - Prompts to enable WiFi if not connected

Installation

1. Connect your Kindle to your computer via USB
2. Copy the plugin folder:

   dropboxsync.koplugin
   

   into:

   koreader/plugins/
   

3. Eject the Kindle and restart KOReader

Prerequisites

Before using this plugin, you need to configure Dropbox in KOReader's Cloud Storage:

1. Open KOReader
2. Go to Tools → Cloud Storage
3. Tap the + button and select Dropbox
4. Follow the prompts to authenticate with your Dropbox account
5. Set the folder you want to sync with

Usage

1. Open the Tools → Dropbox Sync
2. You can:
   • Tap Sync now to run immediately
   • Check Auto-sync on startup to sync when KOReader starts
   • Check Periodic sync to run in the background (default every 30 mins)
   • Configure sync intervals and delays

The plugin will:

• Compare files in your Kindle's home directory with your Dropbox folder
• Download any new files from Dropbox
• Upload any new local files to Dropbox

When running in background mode (auto/periodic), it will effectively be silent unless it transfers files or encounters an error, in which case it will show a detailed summary.

How Sync Works

Scenario	Action
File exists in Dropbox but not locally	Downloaded to Kindle
File exists locally but not in Dropbox	Uploaded to Dropbox
File exists in both locations	No action (name-based matching)

Note: The current sync logic is based on file names only. It does not detect modifications to existing files.

Troubleshooting

"No Dropbox config found"

• Make sure you've configured Dropbox in Cloud Storage first (see Prerequisites)

Plugin not showing in menu

• Verify the folder structure: koreader/plugins/dropboxsync.koplugin/main.lua
• Restart KOReader completely

Sync errors

• Check your WiFi connection
• Try re-authenticating with Dropbox in Cloud Storage

File Locations

Item	Path
Plugin	koreader/plugins/dropboxsync.koplugin/
Plugin configuration	koreader/settings/dropboxsync.lua
Cloud Storage config	koreader/settings/cloudstorage.lua
Menu order config	koreader/settings/filemanager_menu_order.lua
Default sync folder	Your configured KOReader home directory