Import Lists
Import lists automatically sync books from external sources into your Narratorr library as “wanted” books. Once added, Narratorr searches for and downloads them like any other book.
Configure import lists in Settings > Import Lists.
List Types
Section titled “List Types”Audiobookshelf
Section titled “Audiobookshelf”Syncs your Audiobookshelf library into Narratorr. Useful for migrating from Audiobookshelf or keeping the two in sync.
| Field | Description |
|---|---|
| Name | Display name for this list |
| Server URL | Your Audiobookshelf instance URL (e.g., http://audiobookshelf:13378) |
| API Key | Audiobookshelf API key (Settings > Users > your user) |
| Library ID | Which Audiobookshelf library to sync from |
NYT Bestsellers
Section titled “NYT Bestsellers”Adds books from the New York Times bestseller lists. Good for automatically tracking popular new releases.
| Field | Description |
|---|---|
| Name | Display name for this list |
| API Key | NYT Developer API key (developer.nytimes.com) |
| List | Which bestseller list to track. Default: audio-fiction. |
Hardcover
Section titled “Hardcover”Syncs books from Hardcover (hardcover.app) — either trending books or a specific shelf.
| Field | Description |
|---|---|
| Name | Display name for this list |
| API Key | Hardcover API key |
| List Type | trending (popular books) or shelf (a specific shelf) |
| Shelf ID | Required when list type is shelf — the Hardcover shelf ID to sync |
Common Settings
Section titled “Common Settings”Every import list has these shared settings:
| Setting | Description |
|---|---|
| Enabled | Toggle the list on/off without deleting it |
| Sync Interval | How often to sync, in minutes. Default: 1440 (daily). |
How Sync Works
Section titled “How Sync Works”- On each sync cycle, Narratorr fetches items from the external source
- Each item is enriched with metadata (ASIN lookup) if not already known
- If the book doesn’t already exist in your library, it’s added with status
wanted - Duplicate books (matching ASIN or title+author) are silently skipped
- Newly added books appear in your library and are picked up by the next search cycle
Testing and Preview
Section titled “Testing and Preview”- Test — verifies the connection and credentials are valid
- Preview — fetches the first 10 items from the list so you can see what would be imported before enabling
- Sync errors are stored and visible in the list settings — check here if a list stops syncing
- Books added by import lists track which list they came from, visible on the book detail page
- Deleting an import list doesn’t remove books it previously added