Files
wiki/Catalogue-Self-Hosted/apps/app-calibre-web-automated.md
2026-06-09 18:40:21 +02:00

5.1 KiB


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

📝 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é)

# 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

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

Pages Liées