---
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