109 lines
4.5 KiB
Markdown
109 lines
4.5 KiB
Markdown
---
|
|
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
|