The Servarr dev team would like another dev/team to take over the readarr project. Otherwise it's probably just going to atrophy until it's unusable.
Help is wanted in pulling the ~1100 Sonarr cherry-picks from upstream and other development work. The priority would be 1) What you want to fix, 2) Oldest sonarr-pulls first, 3) Other fixes related to what's been pulled, 4) Everything else
Below are the summarized issues of the Readarr Metadata Server.
For the latest updates please refer to the pinned messages in the Readarr Discord
It is only anticipated that Open Library will resolve the 'Large Author Issue' and similar GoodRead's Specific Issues It is likely it will resolve the 522 / similar metadata issues as well.
Due to continuous GoodReads issues - work has begun by a community member and is also being poked at by one of the Servarr Development Team members to migrate to OpenLibrary. Note that Readarr effectively has no active developers at this time and given the berth of the project it will be slow moveing. If you wish to assist with this - please visit us on Discord, acquire the Tester role and meet us in the appropiate channel. Please do not ask for updates as that is not productive and updates will be shared as progress progresses.
Our priority is definitely trying to do this in a way that we do not lose any of the existing libraries - there is a mapping exercise we need to do in the back end to map between goodreads ID and the openlibrary IDs which I believe ISBN is the only solution to at the moment. However this will take a lot of work not just at the metadata server end, but also on the client app end as a migration will be required there for all users to make use of it. This is not a small piece of work due to this.
We are expecting the new meta to be able to take GR IDs and translate, so the readarr code changes should be minimal at first (I would rather confirm it's working before looking at the client migration), but yes pretty much spot on. The expectation is that it doesn't break anyones existing Readarr in the process and it will fully function.
These are unofficial repositories and not official nor endorsed by the Servarr Team use at your own risk
https://github.com/santarrsgrotto/readarr-docker - a Docker compose setup for running Readarr with the custom metadata server, which if you just want to help test on the client side then feel free to
https://github.com/santarrsgrotto/readarr-server - A full metadata server designed for use with a PostgreSQL database containing Open Library data, based on Saghen's work. To use this you will need to install the prerequisites first. This is very much still alpha quality, it should broadly speaking work and has a level of ratings and series support and a full text search, but it needs lots of testing.
https://github.com/santarrsgrotto/mapping - A mapping of Goodreads IDs to Open Library IDs in CSV format as well as some scripts to load said CSVs into the same database as the Open Library data. This repository is ~750 MB so please don't clone it unless you're fully committed to helping on the server side of this since GitHub has bandwidth restrictions. This mapping is also not complete yet, and I will be making updates.
A proof-of-concept container has been created and initial integration is ongoing. It's been identified the main next outstanding steps are
BookInfo is the Servarr Readarr GoodReads Metadata Proxy. Similar to Skyhook for Sonarr.
Resolved: As of 2024-12-28
As Of: 2024-12-13
Updated: 2024-12-28
The metadata server is having issues and effectively dead in the water. The devs are aware. There is nothing feasible that can be done at this time by the community for a specific metadata server issue (unrelated to Goodreads as the source). Please assist the community with the OpenLibrary conversion or the sonarr-pull
Readarr github issues that need to be cherry-picked into Readarr.
The metadata issue was fixed on 9/17. We are still seeing a couple of 429 rate limits and a couple of failed searches, presumably while things get re-cached again and they will continue to improve as time goes on. I have not seen any issues with imports, only with searches to add authors or books. This does not fix the large author issue below, or the 3 month metadata delay. Both of those issues are being worked on with a change to OpenLibrary as the source of data, but that work is long and ongoing (you can self-apply a
!tester
role to yourself and follow along in the #readarr-ol channel to see how that project is coming along, if you're curious). These are 2 separate, concurrent issues that are being solved that do not interconnect. As always, the metadata server is not open source, and there is nothing you can do to help with that part of the issue except to be patient. Dev help is not being solicited/accepted on the metadata server side of things. There are 900+ open issues on the readarr github if you're anxious to help us out. Please start there. This pin will be updated with current information. If you're reading this pin, this is the most current, accurate information about the metadata server, and there is no need to ask in the channel if things have changed.
Resolved: As of 2024-09-17
Text searches seem to be having a bit of a flaky issue, because it does that search directly on Goodreads to get the ID and then searches the metadata server for that ID. To shortcut the problem, use ID based searches directly.
Resolved: As of 2024-09-17
BookInfo returned 429, backing off for
Readarr's metadata server appears to be functioning normally with no 429 or cache issues. As always, I will update this pin if things change. All pins are the current state of readarr and if anything changes, the pins will be updated accordingly.