Deploy Now

Stars

391

Forks

49

Watchers

2

Developer links

Shelfarr

Shelfarr is the request button your book library was missing: anyone in your household can search millions of ebooks and audiobooks, request the format they want, and let automation fetch and shelve it. Discovery searches Open Library, Hardcover, and Google Books with covers, series, editions, and narrator details, so picking between the ebook and the audiobook takes a glance. Hardcover shelves and public reading lists can be previewed and requested, and following an author means their next release surfaces without a manual search. Requests wait for an admin's approval or move straight to searching, where your indexers are queried and every result is scored against your preferred formats, bitrate, and language. The winning release goes to the download client you route it to; finished files are renamed with your templates and delivered into your library's watched folders, which are told to rescan. Nothing found is not the end: searches retry with back-off and flag the request for attention instead of losing it. Family members get their own accounts with roles, two-factor authentication or single sign-on, notifications in the app or on Discord and Telegram, and admins keep manual uploads, API tokens, and download routing under their control. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. GPL-3.0 licensed.

Shelfarr
Shelfarr
Shelfarr
Shelfarr

Benefits

  • Requests without the group chat
  • Household members search and request books themselves with covers and editions in front of them, so the family librarian stops fielding screenshots of book covers by text message.
  • Best release, picked automatically
  • Results from your indexers are scored against the formats, bitrate, and language you prefer, and per-indexer routing sends each result to the right torrent or usenet client.
  • Shelved the moment it lands
  • Finished downloads are renamed with your author, series, and title templates, moved into watched folders, and a library scan is triggered so the book simply appears.
  • Accounts for the whole household
  • Role-based accounts let family request while admins approve, and sign-in supports two-factor authentication or single sign-on through Authentik, Authelia, or Keycloak for the whole household.

Features

  • Three-source book discovery
  • Open Library, Hardcover, and Google Books metadata powers search by title, author, or ISBN with covers, series, edition, and narrator details.
  • Indexer and client orchestration
  • Prowlarr, Jackett, and NZBHydra2 indexers feed qBittorrent, Decypharr, Deluge, Transmission, SABnzbd, and NZBGet through priority routing and automatic release selection.
  • Format preference scoring
  • Preferred, approved, and rejected formats plus bitrate and single-file rules score every result, so auto-selection grabs the edition you would have picked yourself.
  • Hardcover lists and authors
  • Browse trending titles, genres, and public lists, preview your Want to Read shelf, and follow authors so new releases appear without manual searching.
  • Notifications and API
  • Request events notify in-app or through Discord, Telegram, and webhooks, while scoped per-user tokens expose the whole workflow under /api/v1.

Apps Similar to Shelfarr