k3s/documentation/user-facing/productivity-and-creation/shelfmark.md
2026-07-23 18:24:39 -04:00

2 KiB

Shelfmark — Track What You Read & Listen To

Shelfmark is a reading and listening tracker that integrates with Calibre and Audiobookshelf. It provides statistics, ratings, and a clean interface for managing your media consumption.

Access

Features

  • Track books and audiobooks across Calibre and Audiobookshelf libraries
  • Rate and review items after finishing them
  • View reading/listening statistics (books per month, genres, etc.)
  • Sync progress with downstream services automatically
  • OIDC integration — sign in with your Nest account

Getting Started

  1. Open https://magpie.mynest.love in your browser.
  2. Click Sign In and choose Sign in with The Nest.
  3. Shelfmark will automatically connect to your Calibre and Audiobookshelf libraries (if configured by admin).
  4. Start rating and tracking your media!

How It Works

Shelfmark connects to:

  • Calibre library — Pulls book metadata, covers, and reading status
  • Audiobookshelf — Syncs listening progress and ratings
  • Keycloak — Handles authentication via passkeys

Tips

  • Ratings sync: Ratings you give in Shelfmark can be pushed back to Calibre/Audiobookshelf (if enabled).
  • Statistics: Check the stats tab for insights into your reading habits — most-read authors, genres, and yearly summaries.
  • Offline access: Shelfmark is web-only. For offline tracking, consider a dedicated app like Readest or Foliate.
  • Calibre-Web — E-book library (Shelfmark reads from this data)
  • Audiobookshelf — Audiobook server (Shelfmark syncs with this)

TODO: Add screenshot of Shelfmark dashboard showing reading statistics.