From 9fda9d98e5ccce3a4fb3175cdc6f4198e684a357 Mon Sep 17 00:00:00 2001
From: "dosubot[bot]" <131922026+dosubot[bot]@users.noreply.github.com>
Date: Mon, 8 Jun 2026 07:20:09 +0000
Subject: [PATCH 1/2] docs: document auto-time NTP synchronization setting

---
 docs/src/settings/index.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/src/settings/index.md b/docs/src/settings/index.md
index 8d004971..abb19415 100644
--- a/docs/src/settings/index.md
+++ b/docs/src/settings/index.md
@@ -49,6 +49,16 @@ Automatically enter shared mode when connected to a computer, skipping the
 auto-share = false
 ```
 
+### `auto-time`
+
+✏️
+
+Automatically synchronize the device time via NTP when WiFi connects. This will also set the correct timezone. Uses time.cloudflare.com and ipapi.co.
+
+```toml
+auto-time = false
+```
+
 ### `auto-suspend`
 
 ✏️

From e0dcd2f8eed8b012fcf8690306bb166657684948 Mon Sep 17 00:00:00 2001
From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Date: Mon, 8 Jun 2026 07:49:10 +0000
Subject: [PATCH 2/2] docs: add Automatic Time Syncing page to user guide

Add a new top-level user guide page explaining how time sync works,
how to enable it, manual sync via the clock menu, and a privacy note
about the ipapi.co API call used for timezone detection.
---
 docs/src/SUMMARY.md   |  1 +
 docs/src/time-sync.md | 44 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 45 insertions(+)
 create mode 100644 docs/src/time-sync.md

diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md
index 1b14b38b..0dc9fd8a 100644
--- a/docs/src/SUMMARY.md
+++ b/docs/src/SUMMARY.md
@@ -16,6 +16,7 @@
     - [Dictionaries](ui/settings/dictionaries.md)
 - [Library](library/index.md)
   - [Importing](library/importing.md)
+- [Automatic Time Syncing](time-sync.md)
 - [Troubleshooting](troubleshooting/index.md)
 
 ---
diff --git a/docs/src/time-sync.md b/docs/src/time-sync.md
new file mode 100644
index 00000000..ea96ff0d
--- /dev/null
+++ b/docs/src/time-sync.md
@@ -0,0 +1,44 @@
+# Automatic Time Syncing
+
+Cadmus can keep your Kobo's clock accurate by syncing it automatically whenever
+WiFi connects.
+
+## How it works
+
+When enabled, Cadmus will:
+
+1. Detect your timezone based on your IP address.
+2. Fetch the current time from an internet time server.
+3. Update the system clock and hardware clock on your Kobo.
+
+After syncing, the clock in the status bar updates immediately.
+
+## Enabling automatic sync
+
+Open **Main Menu → Settings → General** and turn on **Auto Time**.
+
+You can also enable it manually in your settings file:
+
+```toml
+auto-time = true
+```
+
+## Manual sync
+
+You can trigger a one-time sync without enabling the automatic option:
+
+1. Tap the clock in the top bar.
+2. Select **Sync Time**.
+
+If the sync fails (for example, WiFi is not connected), a notification will let
+you know.
+
+## Privacy
+
+> [!NOTE]
+> Time syncing sends a request to `ipapi.co` to determine your timezone based
+> on your IP address. No personal data is sent — only your device's public IP
+> address is visible to that service as part of the network request.
+
+The actual time is fetched from `time.cloudflare.com` using the standard NTP
+protocol.