111 lines
5.1 KiB
Markdown
111 lines
5.1 KiB
Markdown
---
|
|
title: Calibre-Web Automated
|
|
created: 2026-06-07
|
|
updated: 2026-06-07
|
|
type: app
|
|
tags: [catalogue, books, ebook, calibre, opds, kobo, koreader, ingest, automation]
|
|
confidence: high
|
|
contested: false
|
|
sources: [https://selfh.st/apps/?tag=Books, https://github.com/crocodilestick/Calibre-Web-Automated]
|
|
---
|
|
|
|
# 🤖 Calibre-Web Automated
|
|
|
|
> **Le Calibre-Web de référence, dopé à l'automatisation** — Ingest de 27 formats, conversion automatique, métadonnées enrichies, KOReader/Kobo sync et gestion fine des doublons.
|
|
|
|
## 📋 Informations Générales
|
|
|
|
| Champ | Valeur |
|
|
| :--- | :--- |
|
|
| **Site web** | [github.com/crocodilestick/Calibre-Web-Automated](https://github.com/crocodilestick/Calibre-Web-Automated) |
|
|
| **GitHub** | [crocodilestick/Calibre-Web-Automated](https://github.com/crocodilestick/Calibre-Web-Automated) |
|
|
| **Licence** | GPL-3.0 |
|
|
| **Langage** | JavaScript (48,5%), Python (27,1%) |
|
|
| **Étoiles GitHub** | 5,7k ⭐ |
|
|
| **Dernière MAJ** | 2026-03-11 |
|
|
| **Catégorie** | [[cat-books|Books]] |
|
|
|
|
## 📝 Description
|
|
|
|
**Calibre-Web Automated (CWA)** est un fork ambitieux de [[app-calibre-web]] qui vise à être une **solution tout-en-un** combinant l'UI moderne du projet d'origine avec la **puissance de Calibre** sans devoir gérer une instance desktop Calibre dans un conteneur KasmVNC (verrouillant sur mobile et lourd en RAM).
|
|
|
|
L'idée directrice : on dépose un ebook dans un dossier surveillé, et CWA **ingeste**, **convertit**, **enrichit les métadonnées** (Google Books, ISBNdb, Hardcover, Kobo, LitRes), **fixe les EPUBs pour Kindle** (UTF-8, hyperliens, NCX), et **envoie sur la liseuse** automatiquement. La **détection de doublons hybride** (SQL + fuzzy matching) et les **Magic Shelves** (étagères dynamiques à règles AND/OR) ajoutent une couche d'organisation qui manque à Calibre-Web standard.
|
|
|
|
C'est aujourd'hui **l'option la plus populaire** pour un setup Calibre 100% headless : statistiques internes, backups quotidiens zippés, notif de release, OAuth 2.0/OIDC auto-discovery, KOSync RFC 7617, envoi multi-destinations... CWA pousse le concept jusqu'à pouvoir ingérer des flux de [[app-shelfmark]] ou de sources externes sans intervention.
|
|
|
|
## 🚀 Installation
|
|
|
|
### Option 1 : Docker Compose (recommandé)
|
|
|
|
```yaml
|
|
# docker-compose.yml
|
|
services:
|
|
calibre-web-automated:
|
|
image: ghcr.io/crocodilestick/calibre-web-automated:latest
|
|
container_name: cwa
|
|
environment:
|
|
- PUID=1000
|
|
- PGID=1000
|
|
- TZ=Europe/Paris
|
|
- DOCKER_MODS=linuxserver/mods:universal-calibre
|
|
volumes:
|
|
- ./config:/config
|
|
- ./books:/books
|
|
- ./ingest:/cwa-book-ingest # dépôt auto des nouveaux ebooks
|
|
ports:
|
|
- 8083:8083
|
|
restart: unless-stopped
|
|
```
|
|
|
|
Premier démarrage : `http://localhost:8083`, login `admin` / `admin123` (à changer immédiatement), puis configurer la base Calibre dans `/books`.
|
|
|
|
### Option 2 : Docker unifié avec Shelfmark
|
|
|
|
CWA et [[app-shelfmark]] partagent le même dossier `/books` : Shelfmark télécharge, CWA ingeste, métadonnées et dispatch.
|
|
|
|
## ⚙️ Configuration
|
|
|
|
1. **Magic Shelves** : définissez des règles (ex. : « auteur = Tolkien ET format = EPUB ») pour organiser dynamiquement.
|
|
2. **EPUB Fixer** : laissez-le activé pour garantir la compatibilité Kindle.
|
|
3. **Multi-Format Conversion** : cible par défaut EPUB ; planifiez une fenêtre de conversion nocturne si vous voulez des KEPUB pour Kobo.
|
|
4. **OIDC** : auto-discovery Keycloak / Authentik / Azure AD — idéal en environnement multi-utilisateurs.
|
|
5. **Auto-Send** : configurer le SMTP et lier les adresses e-mail de vos liseuses (Kobo, Kindle par mail).
|
|
6. **Backups** : laisser le service ziper les originaux dans `/config/processed_books`.
|
|
|
|
## 🔄 Alternatives
|
|
|
|
### Open Source
|
|
- [[app-calibre-web]] — Base amont, plus minimaliste
|
|
- [[app-komga]] — Plutôt comics / mangas, mais accepte les EPUB
|
|
- [[app-kavita]] — Lecteur complet cross-platform
|
|
- [[app-grimmory]] — Plateforme unifiée livres + comics (fork de Booklore)
|
|
|
|
### Propriétaires
|
|
- **Calibre desktop** (en complément d'une UI web)
|
|
- **Kindle Library + Send to Kindle**
|
|
- **Google Play Livres**
|
|
|
|
## 🔐 Sécurité
|
|
|
|
- ✅ **OAuth 2.0 / OIDC** auto-discovery (recommandé en multi-utilisateurs)
|
|
- ✅ Permissions fines héritées de Calibre-Web
|
|
- ⚠️ Changez le mot de passe admin par défaut
|
|
- ⚠️ HTTPS obligatoire derrière reverse proxy
|
|
- ⚠️ Le dossier `ingest` peut être sensible (auto-import) — restreignez l'accès
|
|
- ⚠️ Surveillez l'usage du SMTP pour éviter les abus (envoi vers Kindle)
|
|
|
|
## 📚 Ressources
|
|
|
|
- [selfh.st — Books](https://selfh.st/apps/?tag=Books)
|
|
- [GitHub crocodilestick/Calibre-Web-Automated](https://github.com/crocodilestick/Calibre-Web-Automated)
|
|
- [Wiki officiel](https://github.com/crocodilestick/Calibre-Web-Automated/wiki)
|
|
- [Image GHCR](https://github.com/crocodilestick/Calibre-Web-Automated/pkgs/container/calibre-web-automated)
|
|
|
|
## Pages Liées
|
|
|
|
- [[cat-books]] — Vue d'ensemble de la catégorie Books
|
|
- [[app-calibre-web]] — Base amont minimaliste
|
|
- [[app-shelfmark]] — Téléchargeur couplé à CWA
|
|
- [[app-grimmory]] — Plateforme unifiée
|
|
- [[recettes-docker-compose]] — Templates Docker
|