Skip to content

Conversation

@bfordham
Copy link

@bfordham bfordham commented Dec 6, 2025

These changes add providers for metadata for audio books. Gets information about the author, along with summary info.

blfordham and others added 7 commits June 17, 2025 15:26
  author biographies

  Major improvements to audiobook functionality:

  - Add intelligent title extraction from folder structure instead of messy filenames
  - Implement enhanced series detection from tags, titles, and file paths
  - Add OpenLibrary provider with dual-endpoint strategy (works + editions APIs)
  - Create OpenLibrary Person Provider for author biographies and biographical data
  - Implement multi-provider fallback strategy: Local → Google Books → OpenLibrary
  - Add smart metadata merging with priority-based field selection
  - Support various series naming patterns and automatic book numbering
  - Clean up verbose development logging for production use
  - Update entity types from BaseItem to AudioBook for proper typing
  - Add comprehensive README documentation with screenshots
  author biographies

  Major improvements to audiobook functionality:

  - Add intelligent title extraction from folder structure instead of messy filenames
  - Implement enhanced series detection from tags, titles, and file paths
  - Add OpenLibrary provider with dual-endpoint strategy (works + editions APIs)
  - Create OpenLibrary Person Provider for author biographies and biographical data
  - Implement multi-provider fallback strategy: Local → Google Books → OpenLibrary
  - Add smart metadata merging with priority-based field selection
  - Support various series naming patterns and automatic book numbering
  - Clean up verbose development logging for production use
  - Update entity types from BaseItem to AudioBook for proper typing
  - Add comprehensive README documentation with screenshots
@crobibero
Copy link
Member

I appreciate the work you put into this but we are in the middle of splitting this plugin up to separate providers and moving the local providers to be contained in the server (jellyfin/jellyfin#15593, jellyfin/jellyfin#15604, jellyfin/jellyfin#15655)

@dkanada may have more input to the end goal

@bfordham
Copy link
Author

bfordham commented Dec 6, 2025

Good to know. I'm curious what the best path forward is, then. To see about adding these into the server, or pulling the providers into their own plugin.

@dkanada
Copy link
Member

dkanada commented Dec 6, 2025

@bfordham I'll have Google Books and Comic Vine pulled into separate plugins soon so I'd hold off on changes there, but your audiobook providers can be added to the server like jellyfin/jellyfin#15604 since they don't use remote metadata.

OpenLibrary should be its own plugin though - if you create a jellyfin-plugin-openlibrary codebase we can adopt it into the organization once you're happy with it and start managing it from there.

@dkanada
Copy link
Member

dkanada commented Dec 6, 2025

Regarding the OpenLibrary plugin again, not sure if we have a pluggable HTTP client but it should respect ratelimits and set a User-Agent header as requested by the site. @crobibero might know if an interface already exists in Jellyfin but I'll be looking into it at some point to fix the Google Books API ratelimit errors.

@crobibero
Copy link
Member

We don't have it built in but you can copy this implementation from the OpenSubtitles plugin

https://github.com/jellyfin/jellyfin-plugin-opensubtitles/blob/master/Jellyfin.Plugin.OpenSubtitles/ClientSideRateLimiter.cs

@bfordham
Copy link
Author

bfordham commented Dec 6, 2025

That's great info, I appreciate it. I'll see about moving the provider and creating an OpenLibrary plugin.

Related question: I originally did this change about 6 months ago, I came back to the code because I'm wanting to add more features to the audiobooks - support for multiple parts, chapter tracking, etc. Is there a current project to do this that y'all are aware of? I don't want to stumble into ongoing efforts again lol

@dkanada
Copy link
Member

dkanada commented Dec 21, 2025

We don't have an active project for book / audiobook improvements at the moment. Your best route would be to start a new discussion on jellyfin/jellyfin-meta and ping me before making changes. I'll make sure they get routed to the relevant teams so the implementation doesn't conflict with future plans.

I've finished migrating google books at jellyfin/jellyfin-plugin-googlebooks if you want to open any changes there. I'll publish a stable version after the holidays and it will replace this plugin after the next server release. Still need to find some time to migrate the Comic Vine sections.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants