Repository navigation
Description
ReadMeABook version
1.3.0
Deployment type
Unified Docker image
Media backend
Audiobookshelf
Steps to reproduce
- Use ReadMeABook with Audiobookshelf as the media backend and Audible region set to Germany (de).
- Search for the series “Die Tagebücher der Apothekerin”.
- Open series ASIN B0H3C5X19W: https://www.audible.de/series/Die-Tagebuecher-der-Apothekerin-Hoerbuecher/B0H3C5X19W
- Compare the books shown in ReadMeABook with the Audible series page. In my instance, volume 1 is already available in Audiobookshelf, and volumes 4 and 5 are requested. Volumes 2 and 3 are missing from the ReadMeABook series view.
Expected behavior
Volumes 1–5 should appear as distinct books, each with its own availability and request status. Different volumes of the same series should not be treated as alternative editions of the same book, even if their main titles and narrators match and their runtimes are similar. The Audible website displays volume numbers in the titles, and Audnexus provides distinct series positions for these books.
Actual behavior
ReadMeABook displays only volumes 1, 4 and 5.
The logs show that the Audible series scraper finds five books, but the series detail API returns only three.
An AI assistant helped investigate this by reading application logs, querying the public Audnexus API and reviewing the current upstream source code. The missing books were observed by me; the explanation below is an AI-assisted diagnosis and has not yet been confirmed by tracing each deduplication stage in the running application.
Audnexus metadata:
GET https://api.audnex.us/books/{asin}?region=de
Volume 1:
ASIN: B0H36S85HC
title: Die Tagebücher der Apothekerin
runtimeLengthMin: 506
seriesPrimary.position: 1
Volume 2:
ASIN: B0H6N477LX
title: Die Tagebücher der Apothekerin
runtimeLengthMin: 500
seriesPrimary.position: 2
Volume 3:
ASIN: B0H6N6TH8T
title: Die Tagebücher der Apothekerin
runtimeLengthMin: 500
seriesPrimary.position: 3
Volume 4:
ASIN: B0HQZV8WC6
title: Die Tagebücher der Apothekerin 4
runtimeLengthMin: 500
seriesPrimary.position: 4
Volume 5:
ASIN: B0HR12DG1S
title: Die Tagebücher der Apothekerin 5
runtimeLengthMin: 500
seriesPrimary.position: 5
All five have the same narrator and the same seriesPrimary.asin B0H3C5X19W.
For volumes 1-3, Audnexus puts the volume number in the separate subtitle and seriesPrimary.position fields, rather than the main title. For example, volume 2 has:
subtitle: Die Tagebücher der Apothekerin (Light Novels), Band 2
Suspected cause:
In current main, src/app/api/series/[asin]/route.ts calls deduplicateAndCollectGroups(), followed by collapseByExistingWorks().
The deduplication utility groups books by normalized title and narrator, then compares duration and subtitles extracted from the title string. It does not check the separate subtitle field or series position.
Volumes 1-3 therefore appear eligible for false deduplication: identical main titles, identical narrator and runtimes within the tolerance. Volumes 4 and 5 remain distinct because their main titles include the volume numbers.
Please consider guarding against deduplication when books have the same series ASIN but different known series positions. Existing persisted work associations may also need attention if these volumes have already been incorrectly linked.
Docker Compose (or run command)
services:
readmeabook:
image: ghcr.io/kikootwo/readmeabook:latest
container_name: readmeabook
restart: unless-stopped
ports:
- "3030:3030"
volumes:
- ${APPDATA}/readmeabook/config:/app/config
- ${APPDATA}/readmeabook/cache:/app/cache
- /mnt/pool/downloads/complete:/downloads
- /mnt/pool/audio/Hörbuch:/media
- ${APPDATA}/readmeabook/pgdata:/var/lib/postgresql/data
- ${APPDATA}/readmeabook/redis:/var/lib/redis
environment:
PUID: 1000
PGID: 1000Logs
[INFO] [API.Series.Detail] Fetching series detail: B0H3C5X19W, page 1
[INFO] [Audible.Series] Scraping series detail page: B0H3C5X19W, page 1
[INFO] [Audible.Series] Series detail complete: "Die Tagebücher der Apothekerin" (5 books, page 1, hasMore: false)
[INFO] [API.Series.Detail] Series detail complete: "Die Tagebücher der Apothekerin" (3 books, page 1)
Activity
test: shoot the series book grid in the #599 spec
fix: tighten the series volume heal and position fallback
test: skip the #599 spec on a 503 logged over several lines
kikootwo commentedon Nov 16, 2026
Thanks for the clear report and for pointing at the series ASIN plus position as the guard, @FallenLeave91. That's the fix, merged in #614: volumes of one series with different positions are never merged, in the series view or in the saved links, and existing installs heal the wrong links the next time the series page, search or a watched series sync sees them. Volumes 2 and 3 show up again as their own books. It will be in the next release.