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,108 @@
+---
+title: Stump
+created: 2026-06-07
+updated: 2026-06-07
+type: app
+tags: [catalogue, books, comics, manga, ebook, opds, kobo, koreader, rust, react, axum]
+confidence: medium
+contested: false
+sources: [https://selfh.st/apps/?tag=Books, https://github.com/stumpapp/stump, https://stumpapp.dev/]
+---
+
+# 🪵 Stump
+
+> **Un serveur de comics, mangas et ebooks écrit en Rust** — Léger, rapide, avec OPDS v1.2 / v2, lecteurs intégrés et client Tauri desktop.
+
+## 📋 Informations Générales
+
+| Champ | Valeur |
+| :--- | :--- |
+| **Site web** | [stumpapp.dev](https://stumpapp.dev/) |
+| **GitHub** | [stumpapp/stump](https://github.com/stumpapp/stump) |
+| **Licence** | MIT (Expo app : GPL-3.0) |
+| **Langage** | Rust (33,2%) / TypeScript (61,9%) |
+| **Étoiles GitHub** | 2,5k ⭐ |
+| **Dernière MAJ** | 2026-05-29 |
+| **Catégorie** | [[cat-books|Books]] |
+
+## 📝 Description
+
+**Stump** est un **media server** moderne pour **comics**, **mangas** et **livres numériques**, écrit en **Rust** (backend Axum, frontend React, ORM SeaORM). Le projet vise la **simplicité** et la **performance** : binaire unique, démarrages rapides, et un focus sur les fonctions essentielles (lecture, OPDS, multi-utilisateurs) sans empiler les couches.
+
+Formats supportés : **EPUB, PDF, CBZ/ZIP, CBR/RAR**, avec **lecteurs intégrés** pour chaque format et support des **annotations / highlights EPUB**. L'**OPDS v1.2 (PSE) et v2.0** est complet, idéal pour les liseuses et les apps OPDS. La **synchro Kobo et KOReader** est intégrée, et un **client Tauri desktop** est disponible pour ceux qui préfèrent une app native.
+
+Stump est encore en **bêta** (cible : 1.0.0) et développé sur le temps libre de son mainteneur **Aaron Leopold**. La roadmap publique évoque une refonte du système de **jobs** (apalis), une migration de la doc vers **fumadocs**, et l'enrichissement progressif des **scrapers de métadonnées**. C'est une option intéressante si vous cherchez une **alternative plus légère** que [[app-kavita]] ou [[app-komga]].
+
+## 🚀 Installation
+
+### Option 1 : Docker Compose (recommandé)
+
+```yaml
+# docker-compose.yml
+services:
+  stump:
+    image: stumpapp/stump:latest
+    container_name: stump
+    environment:
+      - TZ=Europe/Paris
+    volumes:
+      - ./config:/config
+      - ./data:/data
+      - ./library:/library
+    ports:
+      - 8080:8080
+    restart: unless-stopped
+```
+
+Premier démarrage : `http://localhost:8080`, créer le compte admin, ajouter une bibliothèque pointant vers `/library`.
+
+### Option 2 : Binaire
+
+Téléchargez la dernière release sur [GitHub Releases](https://github.com/stumpapp/stump/releases), lancez `stump`. Idéal pour un homelab bare-metal ou pour tester rapidement.
+
+## ⚙️ Configuration
+
+1. **Bibliothèques** : ajoutez un dossier, Stump scanne et indexe automatiquement.
+2. **Lecteurs** : choisissez le mode (page simple, double, webtoon) par type de média.
+3. **OIDC** : branchez Authentik / Keycloak pour l'auth centralisée.
+4. **Theming** : thèmes intégrés (dark, light, e-ink) + thèmes custom.
+5. **Tauri desktop** : optionnel, pour qui veut une UI native (macOS, Linux, Windows).
+6. **Reverse proxy** : simple à exposer (l'OPDS sera sur `/opds/v1.2/...`).
+
+## 🔄 Alternatives
+
+### Open Source
+- [[app-komga]] — Référence mature, plus de fonctionnalités
+- [[app-kavita]] — Concurrent direct, plus EPUB-centric
+- [[app-calibre-web]] — Plutôt ebooks Calibre
+- [[app-audiobookshelf]] — Spécialisé audiobooks
+- [[app-storyteller]] — Sync narration + ebook
+
+### Propriétaires
+- **YACReader Server**
+- **ComiXology** (rapatrié dans Kindle)
+- **Tachiyomi / Mihon** (clients, pas serveur)
+
+## 🔐 Sécurité
+
+- ✅ Authentification locale + **OIDC**
+- ✅ Permissions fines, restrictions d'âge
+- ✅ Binaires Rust minimalistes, surface d'attaque réduite
+- ⚠️ **Beta software** : ne pas exposer en production critique sans tests
+- ⚠️ Sauvegardez `./config` (SQLite) et `./data`
+- ⚠️ Le mainteneur développe sur son temps libre : pas de garantie de timeline pour les CVE
+
+## 📚 Ressources
+
+- [selfh.st — Books](https://selfh.st/apps/?tag=Books)
+- [Site officiel](https://stumpapp.dev/)
+- [GitHub stumpapp/stump](https://github.com/stumpapp/stump)
+- [Documentation](https://stumpapp.dev/docs/getting-started/installation)
+- [Sponsor — Aaron Leopold](https://github.com/sponsors/aaronleopold)
+
+## Pages Liées
+
+- [[cat-books]] — Vue d'ensemble de la catégorie Books
+- [[app-komga]] — Référence concurrente, plus mature
+- [[app-kavita]] — Concurrent direct EPUB-centric
+- [[recettes-docker-compose]] — Templates Docker