46 lines
2 KiB
Markdown
46 lines
2 KiB
Markdown
# 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.*
|