# calibrain/shelfmark

Repository: https://github.com/calibrain/shelfmark
Canonical: https://ross.abutalabs.com/products/shelfmark
Language: Python
License: MIT
License Family: permissive
Last push: 2026-08-24T22:11:30+00:00

## Health v2 (maintenance only)
Score: 88/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 44
- inputs: {"age_days": 625, "days_push": 9, "days_rel": 9, "gap_med": 3.5, "n_releases_24m": 43}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3793, forks 227 (observed 2026-08-28T04:08:18.833335+00:00)

## What it is
Shelfmark is a self-hosted web application for searching and requesting books and audiobooks across multiple configurable sources such as web, torrent, usenet, and IRC. It provides a unified download queue, multi-user request workflows, and automatic import into library tools like Calibre-Web and Audiobookshelf.

## Use cases
- search and download ebooks from multiple sources in one place
- self-hosted audiobook search and download tool
- let family or friends request books through a shared web UI
- automatically import downloaded books into Calibre-Web
- manage a download queue with real-time progress
- integrate book metadata from Hardcover, Open Library, and Google Books

## When to choose
- you run a self-hosted ebook or audiobook library and want automated acquisition
- you need a multi-user request/approval system for book downloads
- you want one interface aggregating torrent, usenet, IRC, and web sources
- you use Calibre, Calibre-Web, or Audiobookshelf and want automatic imports

## When to avoid
- you need a fully managed cloud service rather than a Docker self-hosted app
- you want active feature development - the project is feature-stable and maintained best-effort
- you cannot spare ~2 GB of RAM for the container
- you only need a simple single-source downloader without metadata or request workflows

## Facets
- artifact type: application
- maturity: maintenance
- function: search-engine, http-client, web-framework, auth, self-hosted
- domain: self-hosted, files, web-development
- platform: self-hosted, python
- tags: ebooks, audiobooks, book-search, calibre, media-downloader, multi-user, requests-management, automation, docker, web-server

## Member repositories
- calibrain/shelfmark (main) score 88

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:18.833335+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:27:01.990970+00:00, confidence not recorded.
  - readme: https://github.com/calibrain/shelfmark (fetched 2026-08-28T04:08:18.833335+00:00, sha 33832b412103)
- Data as of 2026-08-30T08:39:29.467469+00:00.