Initial vault setup

2026-06-09 18:40:21 +02:00
commit bda02d587f
3692 changed files with 402457 additions and 0 deletions
@@ -0,0 +1,126 @@
+---
+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