Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Feature Request: Readarr integration #99

Open
M-Davies opened this issue Jan 25, 2024 · 5 comments
Open

Feature Request: Readarr integration #99

M-Davies opened this issue Jan 25, 2024 · 5 comments

Comments

@M-Davies
Copy link

Might be out of scope for the project so feel free to close if it's a bit off topic.

It would be useful if there was functionality implemented that connected a user's readarr instance to Jelu. The result could be something like Overseerr or Jellyseerr that will automatically start downloads for books on a user's read list if it's setup.

The flow could be something like:

  1. Admin sets up Jelu and Readarr. They input the Readarr server details and credentials into Jelu.
  2. There could be some option that determines when Jelu will send a request to Readarr to search for something. E.g. if a user adds a book to their "Read Later" list, it will automatically send a request to Readarr to start a download
  3. When Readarr finishes the download (or fails to find/finish it), it sends a notification back to the user and a download ebook link on their page.

Currently, nothing like this appears to exist for ebooks, so it would be filling a hole in the self hosting community. However, it's probably a non-trivial feature to implement.

Happy to provide more context if needs be.

@bayang
Copy link
Owner

bayang commented Jan 25, 2024

Why not. But instead of tying this kind of feature to a specific app, I would prefer make it a general "hooks" system.
For instance when a book is added to the to read list a specific hook would be triggered that could call lots of external different services.
I'm not an *arr user myself so I don't know the ecosystem.
I need to think about it.
Just to help me think, can you tell me if readarr exposes an API and if yes, how much data is needed to call readarr and add a specific book to a download list (title, authors, isbn, user infos etc...) ?

@M-Davies
Copy link
Author

That sounds a lot better yeah 👍

Readarr has an API https://readarr.com/docs/api/ Authentication is done via an API key the user can view in the settings. So you'd need to store that within Jelu somewhere secure so Readarr and Jelu can talk to each other.

To give an overview of the process from the GUI on my readarr:

  • User searches for book they want. Usually the author will be found by readarr, not the book first:
    2024-01-25 14_14_44-Window
  • They then add the author to their readarr instance, which can then go off and search for missing books to download:
    2024-01-25 14_15_51-Window
  • They can then see the authors books and can start a download search for specific ones if they haven't already "watched" the author and started a download for all of them:
    2024-01-25 14_16_48-Window

I believe you can do all this via the API and maybe cut out a couple of these steps (e.g. maybe you can search for and download a book directly without having to add the author first)

@bayang
Copy link
Owner

bayang commented Jan 25, 2024

Ok, I'll need to look at the API, it sounds a bit involved to just be a simple hook call.
Thank you for documenting your request.

@jordanlambrecht
Copy link

Upvoting this because Jelu is seriously the closest any service comes, and it's a huge gap in the community. It's so weird that it hasn't been filled yet. It would be awesome if you were the first.

@yoannfelix
Copy link

There is also lazylibrarian but readarr would be preferred.

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

No branches or pull requests

4 participants