Settings - ABS-KoSync

General Settings

Timezone

Log Level

Audiobookshelf (Required)

Limit Search to Configured Library

Server URL

API Token

Library ID

Collection Name (Auto-Add)

Progress Offset (Seconds)

Rewind progress sent to ABS (e.g. -60)

KOSync Integration

Enable

Use Built-in KOSync Bridge (Recommended)

🚀 Public URL (Put this in KOReader)

Replace 'localhost' with your server IP or Domain if accessing remotely.

Target KOSync URL

Internal URL the bridge connects to.

User Credentials

Username

Password

This will be your KOSync password in KOReader.

Hash Method

Use Percentage from Server (Ignore Text Matching)

Storyteller

Enable

API URL

Username

Password

Booklore

Enable

Server URL

Username

Password

Shelf Name

Booklore Library ID (Optional)

Restricts sync to a specific library (e.g., 1). Leave empty to sync all.

Calibre-Web Automated

Enable

Server URL

URL to your Calibre-Web Automated instance (e.g. http://192.168.1.100:8083)

Username

Password

Hardcover.app

Enable

API Token

Telegram Notifications

Enable

Bot Token

Chat ID

Min Log Level

Shelfmark View

Enable

Shelfmark URL

URL to display in the Shelfmark tab (e.g. your Shelfmark instance URL)

Suggestions

Enable

When enabled, the system will look for unmapped audiobooks with progress and suggest matching ebooks from your library.

Sync Behavior

Sync Period (Minutes)

Min ABS Change (Seconds)

Min Ebook Change (%)

Client Diff Threshold (%)

XPath Fallback (Try previous segment if match fails)

Enable ABS Ebook Sync (Bi-directional)

Regenerate Missing Data on Reset

When resetting your progress, check for missing sync data. If found, the system will attempt to regenerate it (which may require re-transcription).

Instant Sync

Triggers immediate sync on ABS playback or KOReader progress. Disable to rely solely on polling.

Per-Client Polling

Global uses the main sync interval. Custom sets a separate check frequency per client.

System Paths

Data Directory

Books Directory

Storyteller Library Path

Target directory where Forge writes files for Storyteller to process.

Storyteller Assets Path (Optional)

Used to ingest Storyteller forced-alignment transcripts when available.

Audiobooks Dir

Advanced Options

Job Max Retries

Job Retry Delay (Mins)

Fuzzy Match Threshold

SMIL Validation Threshold (%)

Minimum token match % to accept EPUB SMIL data. Lower = more lenient.

Suggestion Cleanup

Deletes all suggestions for books that are not currently in your bridge library. This helps clear out junk suggestions and allows the bridge to re-suggest them if needed.

Storyteller Backfill

Re-scan all Storyteller-linked books, ingest available transcript files, and regenerate storyteller-native alignment maps without SMIL or Whisper reprocessing.

Cache Cleanup

Deletes audio cache and transcript files for books that are no longer active. Active books are not affected.

Transcription Provider

Local = faster‑whisper. Deepgram = cloud. Whisper.cpp = external HTTP server.

Whisper.cpp Server URL

Example: http://HOST:11080/audio/transcriptions

Deepgram API Key

Get your key at console.deepgram.com

Deepgram Model

Nova-2 recommended. See Deepgram Models

Whisper Model

Model size for Local Whisper and Whisper.cpp Server. Larger = better accuracy but slower.

Whisper Device

Use CUDA for NVIDIA GPU. Default is CPU.

Whisper Compute Type

Use int8 for CPU, float16 for GPU.

ABS-KoSync

⚙️ Application Settings

General Settings

Audiobookshelf (Required)

KOSync Integration

🚀 Public URL (Put this in KOReader)

User Credentials

Storyteller

Booklore

Calibre-Web Automated

Hardcover.app

Telegram Notifications

Shelfmark View

Suggestions

Sync Behavior

Instant Sync

Per-Client Polling

System Paths

Advanced Options