# Shelfmark — Track What You Read & Listen To

**Shelfmark** is a reading and listening tracker that integrates with [Calibre](https://calibre-ebook.com/) and [Audiobookshelf](../media-and-entertainment/audiobookshelf.md). It provides statistics, ratings, and a clean interface for managing your media consumption.

## Access

- **Web UI:** <https://magpie.mynest.love>
- **Internal (home network):** <http://shelfmark.k3s.home.nest>

## 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](https://github.com/readest/readest) or [Foliate](https://github.com/johnfactotum/foliate).

## Related Services

- [Calibre-Web](../media-and-entertainment/calibre-web.md) — E-book library (Shelfmark reads from this data)
- [Audiobookshelf](../media-and-entertainment/audiobookshelf.md) — Audiobook server (Shelfmark syncs with this)

---

*TODO: Add screenshot of Shelfmark dashboard showing reading statistics.*