127 lines
6.9 KiB
Markdown
127 lines
6.9 KiB
Markdown
---
|
|
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
|