# crocodilestick/calibre-web-automated

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/crocodilestick-calibre-web-automated).**

4,834 stars · 332 forks · JavaScript · gpl-3.0

## Links

- GitHub: https://github.com/crocodilestick/Calibre-Web-Automated
- Homepage: https://github.com/crocodilestick/Calibre-Web-Automated
- awesome-repositories: https://awesome-repositories.com/repository/crocodilestick-calibre-web-automated.md

## Topics

`automation` `calibre` `calibre-web` `conversion` `docker` `ebook` `ebooks` `epub` `import` `kepub` `kindle` `kobo` `self-hosted`

## Description

Calibre-Web-Automated is a self-hosted ebook library server that watches file system folders for new ebook files, automatically converts them to a target format, enriches their metadata from online sources, and inserts them into a Calibre-managed library. It provides a web interface for browsing, reading in-browser, searching full text, and managing collections, while also supporting user authentication through multiple protocols including OAuth 2.0, OpenID Connect, LDAP, magic links, and reverse proxy headers.

The server integrates directly with Kobo e-reader devices, synchronizing books, covers, reading progress, and deletions bidirectionally, and can proxy unfulfilled Kobo requests to the Kobo Store. It also synchronizes reading position with KOReader and Hardcover accounts, and mirrors read status back to a Calibre custom column. Metadata enrichment draws from multiple online sources via a pluggable provider interface, and the system includes a background task queue that handles format conversion, metadata fetching, and backup compression independently of web requests.

Deployment supports custom Docker image building, SSL/TLS encryption, and operation behind common reverse proxies. Daily compressed backups preserve original processed files, and the server provides interactive analytics on library usage and authentication events.

## Tags

### Part of an Awesome List

- [Self-Hosted Web Servers](https://awesome-repositories.com/f/awesome-lists/media/ebook-library-management/self-hosted-web-servers.md) — Provides a self-hosted web interface for browsing, reading, and managing a Calibre ebook library.
- [Automated Ingestion Pipelines](https://awesome-repositories.com/f/awesome-lists/productivity/ebook-management/ebook-metadata-editing/automated-ingestion-pipelines.md) — Watches folders or uploads for new ebooks, converts formats, and enriches metadata automatically.
- [Online Source Enrichments](https://awesome-repositories.com/f/awesome-lists/productivity/ebook-management/ebook-metadata-editing/online-source-enrichments.md) — Fetches, edits, and embeds author, series, tags, and cover data from online sources into ebook files.
- [Authentication and OAuth](https://awesome-repositories.com/f/awesome-lists/security/authentication-and-oauth.md) — Supports OAuth 2.0, OpenID Connect, LDAP, magic link, reverse proxy, and password authentication with role mapping and audit logging.

### Content Management & Publishing

- [Automated Ebook Ingestion Systems](https://awesome-repositories.com/f/content-management-publishing/automated-ebook-ingestion-systems.md) — Monitors watch folders and uploads to automatically ingest ebooks, convert formats, fetch metadata, and add them to the library.
- [Automatic Ebook Ingestion Pipelines](https://awesome-repositories.com/f/content-management-publishing/content-management-systems/content-architecture-modeling/content-organization-systems/ebook-content-management/automatic-ebook-ingestion-pipelines.md) — Ingests new ebook files from watch folders, converts them to a target format, fetches metadata, and inserts them into the library automatically. ([source](https://cdn.jsdelivr.net/gh/crocodilestick/calibre-web-automated@main/README.md))
- [Book Collection Trackers](https://awesome-repositories.com/f/content-management-publishing/media-management/audiobook-servers/e-book-servers/comic-book-libraries/book-collection-trackers.md) — Detects and merges duplicate books, batch edits metadata, and creates dynamic rule-based shelves. ([source](https://cdn.jsdelivr.net/gh/crocodilestick/calibre-web-automated@main/README.md))
- [E-reader Delivery Pipelines](https://awesome-repositories.com/f/content-management-publishing/media-management/audiobook-servers/e-book-servers/e-reader-delivery-pipelines.md) — Synchronizes books, covers, metadata, and reading progress with Kobo e-reader devices. ([source](https://cdn.jsdelivr.net/gh/crocodilestick/calibre-web-automated@main/README.md))
- [Kobo Device Syncs](https://awesome-repositories.com/f/content-management-publishing/media-management/audiobook-servers/e-book-servers/e-reader-delivery-pipelines/kobo-device-syncs.md) — Syncs books, covers, reading progress, and deletions between a self-hosted library and a Kobo device.
- [Library Synchronization](https://awesome-repositories.com/f/content-management-publishing/media-management/media-servers/library-synchronization.md) — Synchronizes the self-hosted ebook library with Kobo e-reader devices bidirectionally. ([source](https://github.com/crocodilestick/Calibre-Web-Automated/wiki/Kobo-Integration-&-Sync))
- [Reading Progress Synchronization](https://awesome-repositories.com/f/content-management-publishing/reading-progress-synchronization.md) — Synchronizes reading position across KOReader, Kobo, and other devices through background sync.
- [Ebook Metadata Enrichments](https://awesome-repositories.com/f/content-management-publishing/ebook-metadata-enrichments.md) — Fetches comprehensive metadata from online sources and embeds it into ebook files during ingestion and download.

### Development Tools & Productivity

- [Ebook Watch Folders](https://awesome-repositories.com/f/development-tools-productivity/javascript-and-typescript-build-systems/watch-modes/ebook-watch-folders.md) — Monitors a watch folder or web upload for new ebook files, detects formats, and adds them to the library. ([source](https://github.com/crocodilestick/Calibre-Web-Automated/wiki/Enhanced-Ingest-System))

### Security & Cryptography

- [Authentication Protocols](https://awesome-repositories.com/f/security-cryptography/authentication-protocols.md) — Supports OAuth 2.0, OpenID Connect, LDAP, magic link, reverse proxy, and password authentication with role mapping and audit logging.
- [Reverse Proxy Authentication](https://awesome-repositories.com/f/security-cryptography/reverse-proxy-authentication.md) — Trusts authentication headers set by an upstream reverse proxy to authenticate users and auto-create accounts.

### User Interface & Experience

- [Web Library Browsers](https://awesome-repositories.com/f/user-interface-experience/web-library-browsers.md) — Provides a web interface for browsing, reading, and managing a Calibre ebook library.

### Web Development

- [Ebook File Readers](https://awesome-repositories.com/f/web-development/api-management-tools/api-development-management/web-apis/file-reading/ebook-file-readers.md) — Opens supported ebook formats in a web-based viewer without requiring a download. ([source](https://github.com/crocodilestick/Calibre-Web-Automated/wiki/Configuration))
- [Ebook Metadata Enrichments](https://awesome-repositories.com/f/web-development/user-metadata-management/event-metadata/cloud-metadata-enrichment/ebook-metadata-enrichments.md) — Fetches comprehensive metadata from multiple online sources and applies it to newly ingested books. ([source](https://github.com/crocodilestick/Calibre-Web-Automated/wiki/Auto-Metadata-Fetch-System))

### Data & Databases

- [Full Text Search](https://awesome-repositories.com/f/data-databases/full-text-search.md) — Indexes full text of ebooks and enables searching within content, not just metadata. ([source](https://github.com/crocodilestick/Calibre-Web-Automated/wiki/Configuration))

### Graphics & Multimedia

- [Metadata Embedding](https://awesome-repositories.com/f/graphics-multimedia/image-metadata-extraction/metadata-embedding.md) — Writes title, author, series, tags, and cover art into ebook files during download or conversion. ([source](https://github.com/crocodilestick/Calibre-Web-Automated/wiki/Configuration))

### System Administration & Monitoring

- [File System Watchers](https://awesome-repositories.com/f/system-administration-monitoring/file-system-watchers.md) — Monitors directories for new ebook files using OS-level notifications to trigger automatic ingestion.
- [OAuth 2.0 Provider Integrations](https://awesome-repositories.com/f/system-administration-monitoring/user-account-management/multi-user-account-systems/oauth-2-0-provider-integrations.md) — Authenticates users through any OAuth 2.0 or OpenID Connect provider with automatic endpoint discovery and role mapping. ([source](https://github.com/crocodilestick/Calibre-Web-Automated/wiki/OAuth-Configuration))
