Skip to content

Series volumes 2 and 3 disappear, apparently deduplicated because Audnexus titles match #599

Closed

Description

@FallenLeave91

ReadMeABook version

1.3.0

Deployment type

Unified Docker image

Media backend

Audiobookshelf

Steps to reproduce

  1. Use ReadMeABook with Audiobookshelf as the media backend and Audible region set to Germany (de).
  2. Search for the series “Die Tagebücher der Apothekerin”.
  3. Open series ASIN B0H3C5X19W: https://www.audible.de/series/Die-Tagebuecher-der-Apothekerin-Hoerbuecher/B0H3C5X19W
  4. 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: 1000

Logs

[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

  1. kikootwo commented on Nov 16, 2026

    @kikootwo
    Owner

    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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions