Sync Behavior

Choose sync mode and configure WiFi connection behavior for sync actions.

🔗Sync Behavior

Use this page to configure when sync runs and how the plugin handles WiFi for network actions.

Found at: Tools → BookLore Sync → Sync Behavior

🔗What this guide does

This guide helps you:

  1. Choose between automatic and manual queue-only sync mode.
  2. Tune WiFi/network timing for slow or unstable connections.
  3. Verify that sync behavior matches your device/network conditions.

🔗Prerequisites

  • Plugin is enabled.
  • Connection credentials are already configured in Connection Setup.

🔗Steps

🔗1. Choose a sync mode

Open Tools → BookLore Sync → Sync Behavior and choose one mode:

  • Automatic (sync on suspend when connected)

    • Queues session/progress on suspend and attempts sync on suspend/resume only when WiFi is already connected.
    • Suspend/resume background sync does not enable WiFi; if disconnected, data stays queued for the next trigger.
    • Manual actions (for example Sync Pending Now) can still auto-enable/connect WiFi when invoked explicitly.
    • Close-time uploads are flushed shortly after close (deferred close flush). If Silent mode is enabled, no progress popup is shown during this flush and the UI may appear briefly unresponsive while pending items upload.

  • Manual only (cache everything)

    • Always queues data locally.
    • No automatic upload; you run Sync Pending Now when ready.

🔗2. Configure networking behavior

Open Tools → BookLore Sync → Sync Behavior → Networking.

  • WiFi connect timeout (seconds)

    • Maximum wait after requesting WiFi connect.
    • Increase on slower devices/networks.

  • Run until connect

    • Disables plugin-side timeout and waits until WiFi connects (or KOReader/network stack times out).
    • Useful when fixed timeout is too short.

  • Sync delay after connect

    • Waits additional time after WiFi reports connected before sending sync requests.
    • Useful when DNS/routing is not ready immediately after connect.

🔗Verification / expected result

  • In Automatic mode, you should see pending counts stay low under normal connectivity.
  • In Manual only mode, pending items should accumulate until you run Sync Pending Now.
  • If networking tuning is correct, manual sync should stop failing with early WiFi timeout/connectivity errors.

You can confirm queue state at:

Tools → BookLore Sync → Sync & Cache → View Pending Sessions

🔗Next steps