k3s/documentation/user-facing/media-and-entertainment/calibre-web.md

# Calibre-Web — E-Book Library

**Calibre-Web** is a web-based e-book manager that provides a clean interface to browse, read, and manage your e-book collection. It connects to a Calibre database for metadata and covers.

## Access

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

## Features

- Browse e-books by title, author, series, or tag
- Read books directly in the browser with an integrated viewer
- Download books in your preferred format (EPUB, PDF, MOBI, AZW3)
- Manage metadata: edit titles, authors, covers, and descriptions
- Support for multiple libraries

## Getting Started

1. Open <https://rookery.mynest.love> in your browser.
2. Click **Sign In** and choose **Sign in with The Nest**.
3. Browse the library or use the search bar to find a book.
4. Click **Read Online** to view in-browser, or **Download** to save locally.

## Supported Formats

- **EPUB** — Best for most e-readers and apps
- **PDF** — Universal compatibility
- **MOBI / AZW3** — Kindle-compatible formats
- **TXT** — Plain text (no formatting)

## Tips

- **Kindle delivery:** If you have a Kindle, use the "Send to Kindle" feature (if enabled by admin) to deliver books directly to your device.
- **Series ordering:** Books in a series are automatically ordered. Use the series view to read them in sequence.
- **Metadata editing:** Some metadata fields can be edited directly in the web UI. Changes sync back to the Calibre database.

## Where Does the Content Come From?

E-books are stored on an NFS share (`robin.home.nest:/yarr/media/books/calibre-library`). New books are added by:

- **[Shelfmark](../media-request/shelfmark.md)** — Users can request ebooks directly through Shelfmark, which automatically populates the Calibre library.
- **Admin upload** — The admin may add books manually via the `calibre-ingest` directory (monitored for new files).
- **Calibre-Web upload** — If enabled by admin, you can upload books directly through the web UI.

## Related Services

- [Shelfmark](../media-request/shelfmark.md) — Request ebooks and audiobooks (populated into Calibre library)
- [Audiobookshelf](../media-and-entertainment/audiobookshelf.md) — For audiobooks instead of e-books

---

*TODO: Add screenshot of Calibre-Web library with a sample book cover.*