---
title: Autocaliweb
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, books, calibre, opds, kobo, ingest, fork, python]
confidence: medium
contested: true
sources: [https://selfh.st/apps/?tag=books, https://codeberg.org/gelbphoenix/autocaliweb]
---

# 📚 Autocaliweb

> **Fork moderne de Calibre-Web + Calibre-Web-Automated** : unifiez l'auto-ingestion, la conversion et l'organisation de votre bibliothèque Calibre, avec un workflow « drop-folder ».

| Métadonnée | Valeur |
| :--- | :--- |
| **Site web** | [codeberg.org/gelbphoenix/autocaliweb](https://codeberg.org/gelbphoenix/autocaliweb) |
| **Codeberg** | [gelbphoenix/autocaliweb](https://codeberg.org/gelbphoenix/autocaliweb) |
| **License** | GPL-3.0 |
| **Langage** | Python, JavaScript, HTML/CSS |
| **Étoiles** | 232 ⭐ (GitHub miroir) |
| **Dernière MAJ** | 2025-12 (v0.11.3) |
| **Catégorie** | [[cat-books]] |

## Description

⚠️ **Note importante** : depuis le **1er février 2026**, le développement d'Autocaliweb a **migré de GitHub vers Codeberg**. Le dépôt GitHub `gelbphoenix/autocaliweb` est archivé et en lecture seule. Le repo actif est sur Codeberg.

Autocaliweb est un **fork consolidé de Calibre-Web** (janeczku) **et Calibre-Web-Automated** (CWA, crocodilestick) — deux projets qui étaient devenus difficiles à merger. L'idée : reprendre le meilleur des deux et ajouter des fonctions propres. Le tout en GPL-3.0, ce qui garantit la pérennité pour la communauté.

Concrètement, Autocaliweb offre une **UI web responsive Bootstrap 3** pour parcourir, lire, télécharger, uploader des eBooks à partir d'une **base Calibre existante**. Mais là où Calibre-Web classique s'arrête, Autocaliweb ajoute toute la couche « automated » : **ingestion automatique** (drop dans un dossier watché), **conversion automatique** vers les formats cibles (EPUB, MOBI, AZW3, KEPUB pour Kobo), **fetching automatique des métadonnées** (Google, Amazon, OpenLibrary, **ISBNDB, Amazon JP, Hardcover, LitRes**), **fix-up EPUB automatique**, **détection de doublons**, et **envoi automatique vers la liseuse**.

Fonctionnalités **uniquement** dans Autocaliweb (vs Calibre-Web vanilla) : usage de `DOCKER_MODS` LinuxServer, support OIDC custom, sync KOReader, sync Hardcover.app pour Kobo, support de plugins Calibre custom, LitRes comme provider, gestion de doublons, génération de couvertures génériques pour livres sans cover, **split library support**.

Sync Kobo, KOReader, intégration E-Reader complète. RBAC fin par utilisateur (un user peut voir mais pas uploader, etc.). 20+ langues d'interface.

**Points forts** : fusion de deux forks concurrents, **drop-folder automatique** vraiment clé en main, sync Kobo/KOReader aboutie, OIDC + RBAC + LDAP + OAuth, 4 métadata providers, support plugins Calibre, licence GPL-3.0.

**Points faibles** : **très jeune** (fork consolidé récemment), **bus factor 1** (gelbphoenix seul mainteneur principal), **migration GitHub → Codeberg** a perturbé la communauté et le rythme, **contesté** : la fragmentation Calibre-Web vs Calibre-Web-Automated vs Autocaliweb est dure à lire, base installée encore faible, documentation en cours de stabilisation, Windows Docker non supporté (WSL « à vos risques »).

## Installation

### Via Docker (recommandé)

L'image `gelbphoenix/autocaliweb` est sur Docker Hub. La méthode officielle : télécharger un `docker-compose.yml` minimal et le lancer.

```yaml
# docker-compose.yml
services:
  autocaliweb:
    image: gelbphoenix/autocaliweb:latest
    container_name: autocaliweb
    restart: unless-stopped
    ports:
      - "8083:8083"
    environment:
      - TZ=Europe/Paris
      - PUID=1000
      - PGID=1000
    volumes:
      - ./config:/config
      - ./ingest:/acw-book-ingest
      - /chemin/calibre/library:/calibre-library
    stop_signal: SIGINT
    stop_grace_period: 15s
```

> **Note** : Windows + Docker Desktop **non supporté** (WSL possible mais à vos risques).

### Installation manuelle

Script officiel `scripts/manual_install_acw.sh` sur le repo. Python 3.11+, Calibre CLI installé (pour la conversion), base Calibre existante.

## Configuration

1. Monter votre bibliothèque Calibre existante sur `/calibre-library`.
2. Monter un dossier `/acw-book-ingest` pour le **drop-folder** automatique (tout EPUB/PDF déposé sera ingéré, converti, métadata-isé et rangé).
3. Premier démarrage : créer le compte admin, configurer la timezone, ajouter les providers de métadonnées voulus (Hardcover, ISBNDB, OpenLibrary).
4. Activer le **Sync Kobo** si vous avez une liseuse Kobo (URL d'API, clé).
5. Activer le **Sync KOReader** si vous utilisez un appareil KOReader.
6. Configurer OIDC/LDAP si vous voulez déléguer l'auth.
7. Brancher la **conversion auto** (EPUB → AZW3 pour Kindle, EPUB → KEPUB pour Kobo).
8. Lancer le **fix EPUB auto** pour normaliser les fichiers en entrée.

## Alternatives

### Open source
- [[app-calibre]] — Le logiciel original, GUI desktop, pas un serveur
- **Calibre-Web** (janeczku) — Le projet source, plus ancien, plus grand public
- **Calibre-Web Automated** (CWA, crocodilestick) — L'autre moitié du fork, encore maintenu en parallèle
- **Kavita** — Lecteur moderne, EPUB/CBZ, sync KOReader, plus simple mais sans ingest
- **Bookdrop** — Outil minimal d'ingestion Calibre sans le reste
- **Calibre2OPDS** — Générateur de catalogue OPDS statique, pas de serveur

### Propriétaires
- **Calibre (desktop)** — Gratuit mais pas self-hostable serveur
- **Kindle Cloud / Kobo Cloud** — Sync cloud propriétaire, pas self-hosted
- **BookFusion** — SaaS EPUB, freemium

## Sécurité

- ⚠️ **Bus factor 1** : gelbphoenix est très actif mais seul aux commandes
- ⚠️ **Migration GitHub → Codeberg** : suivre le bon repo (Codeberg désormais) pour les issues
- ✅ **OIDC + LDAP + Google/GitHub OAuth** supportés
- ✅ **RBAC** granulaire par utilisateur
- ⚠️ **Windows non supporté** : prévoyez Linux/WSL
- ⚠️ **Ingest folder** : tout fichier déposé est converti + modifié → risque EPUB malformé, isoler le réseau
- ✅ **Sync Kobo/KOReader** sur HTTPS obligatoire
- ⚠️ **Contesté** : 3 forks Calibre-Web qui se marchent dessus — vérifier la roadmap avant de s'engager

## Ressources

- [Codeberg gelbphoenix/autocaliweb](https://codeberg.org/gelbphoenix/autocaliweb)
- [GitHub gelbphoenix/autocaliweb (archive)](https://github.com/gelbphoenix/autocaliweb)
- [Reddit — présentation](https://www.reddit.com/r/selfhosted/comments/1kk2uw2/autocaliweb_a_web_managing_platform_for_ebooks/)
- [selfh.st Books](https://selfh.st/apps/?tag=books)

## Pages Liées

- [[cat-books]] — Catégorie Books
- [[app-calibre]] — Le projet original dont Autocaliweb est un fork
- [[app-kavita]] — Lecteur moderne EPUB/CBZ (pas d'ingest auto)
- [[app-readarr]] — Gestion des métadonnées livres (arr stack)
- [[recettes-docker-compose]] — Templates Docker
- [[app-traefik]] — Reverse-proxy HTTPS