ABS-KoSync

ABS-KoSync
πŸ“š Docs ← Dashboard πŸ“Š Logs ⚑ Forge πŸ’‘ Suggestions

βš™οΈ Application Settings

General Settings

Audiobookshelf

Enter disabled to skip Audiobookshelf
Enter disabled to skip Audiobookshelf
Use when restricting ABS search to a specific library.
Rewind progress sent to ABS (e.g. -60)

KOSync Integration

Enable

πŸš€ Public URL (Put this in KOReader)

Replace 'localhost' with your server IP or Domain if accessing remotely.
Internal URL the bridge connects to.

User Credentials

This will be your KOSync password in KOReader.

Storyteller

Enable

Grimmory

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

Device Sync Collections

Automatically creates KOReader collections based on Grimmory shelf membership (Note: This feature only works with bridgesync.koplugin active on your KOReader device).
Comma-separated list of Grimmory shelf names to skip when creating KOReader collections.

Calibre-Web Automated

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

OPDS Library

Reading Progress Sync

Sync reading progress via CWA's Kobo sync protocol. Works with stock Kobo and KOReader.
From CWA β†’ User Settings β†’ Kobo Sync Token.

Hardcover.app

Enable

Telegram Notifications

Enable

Shelfmark View

Enable
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

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.

Recommended: 300s for Grimmory.

System Paths

Target directory where Forge writes files for Storyteller to process.
Used to ingest Storyteller forced-alignment transcripts when available.

Advanced Options

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

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.

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

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

Rebuilds Grimmory cache immediately, including stale metadata refresh.

Local = faster‑whisper. Deepgram = cloud. Whisper.cpp = external HTTP server.
Example: http://HOST:11080/audio/transcriptions
Get your key at console.deepgram.com
Nova-2 recommended. See Deepgram Models
Model name for Local Whisper and Whisper.cpp Server. Pick a common model from the suggestions or enter a custom whisper.cpp model name. Larger = better accuracy but slower.
Use CUDA for NVIDIA GPU. Default is CPU.
Use int8 for CPU, float16 for GPU.
⚠️ Application will restart instantly