How to Use

Find answers and step-by-step guides for NeoQN's advanced features, cloud integrations, and sync tools.

How to use Telegram Backup?

The Telegram Cloud Backup system uploads your library backups directly to a personal Telegram chat or channel. This creates a secure, off-site, and private history of your reading progress.

Step 1: Create a Telegram Bot

1. Open Telegram and search for the official @BotFather bot.
2. Start a chat and send the command /newbot.
3. Follow the instructions to choose a name and username for your bot.
4. Copy the HTTP API Token generated by BotFather (e.g., 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ).

Step 2: Get Your Chat ID

1. Search for @userinfobot or @GetIdsBot in Telegram.
2. Send any message to the bot. It will reply with your unique chat/user ID (a string of numbers, e.g., 987654321).
3. Alternatively, if you want backups sent to a channel, add your new bot as an administrator to the channel and use its channel ID.

Step 3: Configure Settings in NeoQN

1. Go to Settings → Advanced Settings → Telegram Cloud Backup.
2. Paste your Bot Token and Chat ID.
3. Toggle the options based on your preference:

- Delete After Upload: Automatically purges the local backup file from your device storage once the bot successfully sends it to Telegram. - Compile Downloads: Packages and zips your downloaded novel chapters to include in the backup.

1. Tap Backup Now to send your downloaded books to the bot for back them up.

How to use Google Account Backup/Restore?

Google Account Sync provides automated, background synchronisation of your bookmarks, reading progress, and custom settings across multiple Android devices using your private Google Drive app data sandboxed folder.

Step 1: Sign In

1. Go to Settings → Storage & Backups → Google Sync.
2. Tap Sign In with Google.
3. Select your Google account.
4. Authorise the app to use the hidden App Data folder (this is a isolated space invisible to normal Google Drive browsing, ensuring your backups remain secure).

Step 2: Enable Automated Syncing

1. Toggle Auto Sync to ON.
2. The background worker (GoogleSyncWorker) will run periodically every 12 hours on an unmetered network connection when the device is not low on battery.
3. Tap Sync Now to force an immediate manual backup or restore.

How Conflict Resolution Works

When sync runs, NeoQN compares your local database with the remote copy in Google Drive:

• Two-way Merge: For each novel bookmark, it compares the lastUpdated timestamp and keeps the newer state.
• Unique Appends: Custom reader themes and text cleaning rules are combined uniquely by name/ID so you don't lose custom configs.
• Device Precedence: In case of identical timestamps, local preferences take precedence.

How to use Local WiFi Sync?

Local WiFi Sync allows you to transfer your entire NeoQN library, history, and preferences directly between two devices on the same local network without uploading files to the cloud.

Setup Requirements

• Both Android devices must be connected to the same Wi-Fi router.
• If a VPN or AdBlocker is active on either device, turn it off temporarily to prevent local IP routing issues.

Step 1: Prepare the Receiving Device

1. Open the Settings menu on the device you want to transfer data to.
2. Tap WiFi Sync and select Receive Data.
3. The device will start a local HTTP server (LocalSyncServer) and display:

- A secure QR Code. - The local sync address (e.g., http://192.168.1.50:8080/sync).

Step 2: Send from the Source Device

1. Open the Settings menu on the device containing your library.
2. Tap WiFi Sync and select Send Data.
3. Point your camera at the QR code on the receiving device's screen.
4. Once scanned (via ML Kit), the source device will compile a database checkpoint (outgoing_sync.json) and transfer it over the local connection.
5. The receiving device will display "Data successfully transferred" and reboot to reload the database.