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,122 @@
+---
+title: Mantium
+created: 2026-06-07
+updated: 2026-06-07
+type: app
+tags: [catalogue, books, manga, tracker, analytics, go, python, dashboard]
+confidence: medium
+contested: true
+sources: [https://selfh.st/apps/?tag=books, https://github.com/diogovalentte/mantium]
+---
+
+# 📚 Mantium
+
+> **Tracker manga auto-hébergé** : suivez vos lectures de mangas, light novels et comics multi-sources (MangaDex, MangaPlus, MangaUpdates…) avec un dashboard et une iFrame intégrable.
+
+| Métadonnée | Valeur |
+| :--- | :--- |
+| **Site web** | [github.com/diogovalentte/mantium](https://github.com/diogovalentte/mantium) |
+| **GitHub** | [diogovalentte/mantium](https://github.com/diogovalentte/mantium) |
+| **License** | MIT |
+| **Langage** | Go (76 %), Python (20 %), Lua (4 %) |
+| **Étoiles** | 139 ⭐ |
+| **Dernière MAJ** | 2026-06 (v6.0.9) |
+| **Catégorie** | [[cat-books]] |
+
+## Description
+
+⚠️ **Note honnête** : Mantium est catégorisé par selfh.st sous le tag **Books**, mais son objet réel est le **suivi de mangas** (et plus largement comics / light novels / manhwas), pas la lecture de livres. Il ne télécharge aucun chapitre : il **agrège les métadonnées** (titre, couverture, chapitres, dates de sortie) depuis des sources publiques et garde la trace de votre progression de lecture.
+
+Mantium est l'œuvre d'un **auteur principal unique** (Diogo Valentim) plus 2 contributeurs occasionnels — typiquement un **bus factor 1**, à accepter si vous misez dessus. Le code est jeune (quelques releases majeures par an) et l'API est bien découpée.
+
+La force du projet : la notion de **« Multimanga »** qui fusionne automatiquement les entrées d'un même titre trouvées sur plusieurs sites sources. Vous lisez la même série sur MangaDex et MangaPlus ? Mantium n'affiche qu'une carte et unifie la progression. Les sources officiellement supportées sont MangaDex, MangaPlus, MangaHub, MangaUpdates, RawKuma, KLManga, JManga, plus une **fonction Custom Manga** (sélecteurs CSS/XPath) qui ouvre la porte à n'importe quel site.
+
+Côté dashboard : vue grille ou liste, **animation de mise en évidence** des séries non lues, filtres par statut (reading, completed, dropped, on hold, plan to read), tri multi-critères. Mantium expose aussi un **endpoint iFrame** léger, idéal pour l'embarquer dans [[app-homarr]] ou [[app-homepage]] et afficher vos séries en cours sur un dashboard d'homelab.
+
+Fonctionnalités principales : **Multimanga** auto-merge inter-sources, **Custom Manga** (sélecteurs CSS/XPath), dashboard Grid/List avec **iFrame intégrable**, notifications de nouveaux chapitres, thèmes sombre/clair, **API REST** documentée.
+
+**Points forts** : dashboard moderne et rapide, iFrame prête à l'emploi, fonction Multimanga vraiment unique, licence MIT, image Docker disponible, API propre.
+
+**Points faibles** : **bus factor 1** (un seul mainteneur actif, projet perso), pas de lecteur intégré (le suivi seulement), pas de téléchargement, sources non-officielles instables, base installée faible, **contesté** sur le tag « Books » de selfh.st car c'est avant tout un outil manga.
+
+## Installation
+
+### Via Docker (recommandé)
+
+L'image officielle `ghcr.io/diogovalentte/mantium` est publiée sur GitHub Container Registry. Le projet se compose de deux services : `dashboard` (front Svelte) et `api` (back Go + worker Python).
+
+```yaml
+# docker-compose.yml
+services:
+  mantium-api:
+    image: ghcr.io/diogovalentte/mantium-api:latest
+    container_name: mantium-api
+    restart: unless-stopped
+    environment:
+      - TZ=Etc/UTC
+    volumes:
+      - mantium_data:/app/data
+
+  mantium-dashboard:
+    image: ghcr.io/diogovalentte/mantium-dashboard:latest
+    container_name: mantium-dashboard
+    restart: unless-stopped
+    ports:
+      - "8090:80"
+    depends_on:
+      - mantium-api
+
+volumes:
+  mantium_data:
+```
+
+### Installation manuelle
+
+Voir la doc : `https://github.com/diogovalentte/mantium`. Back-end : Go 1.21+, Python 3.11+ (pour le worker de scraping), SQLite (par défaut) ou PostgreSQL. Front : Svelte/Node, `npm run build` puis reverse-proxy.
+
+## Configuration
+
+1. Démarrer l'API et le dashboard.
+2. Ouvrir l'UI sur `http://IP:8090`, créer le premier compte admin.
+3. Ajouter une source en colant l'URL d'un manga depuis MangaDex/MangaPlus (ou utiliser la recherche native).
+4. Régler la fréquence de polling (par défaut 30 min) dans `Settings → Background Jobs`.
+5. Si vous voulez l'**iFrame** dans un dashboard externe, exposer l'API en HTTPS (sinon les navigateurs modernes bloqueront l'iFrame mixte HTTP/HTTPS).
+6. Activer `TELEMETRY_ENABLED=false` côté API si vous voulez désactiver le ping Plausible (compteur anonymisé d'instances actives).
+
+## Alternatives
+
+### Open source
+- [[app-bookwyrm]] — Réseau social lecteurs, mais pour « vrais » livres
+- **Kavita** — Lecteur comics/manga/LN avec OPDS, plus complet (téléchargement, lecture)
+- **Komga** — Serveur comics/manga OPDS, très mature
+- **Manga-Tracker** (NPM) — Outil similaire mais sans Multimanga
+- [[app-stump]] — Comics/manga server écrit en Rust, plus jeune
+
+### Propriétaires
+- **MangaUpdates** — Le « Goodreads » des mangas, mais tracking manuel
+- **AniList** — Réseau social anime/manga, freemium
+- **MyAnimeList** — Idem, freemium, propriété de DeNA
+
+## Sécurité
+
+- ⚠️ **Bus factor 1** : un seul mainteneur — pas de garantie de correction rapide en cas de bug critique
+- ✅ **HTTPS obligatoire** si vous voulez utiliser l'iFrame dans un dashboard externe
+- ✅ Pas d'auth native par défaut — mettre derrière un [[app-authentik]] ou un [[app-caddy]] + basic auth
+- ⚠️ Les sources non-officielles (KLManga, JManga…) peuvent disparaître du jour au lendemain
+- ⚠️ Aucun téléchargement de chapitre = pas de problème de copyright direct, mais le scraping des métadonnées reste en zone grise pour les sources non-officielles
+- ⚠️ **Projet jeune** : la base installée est faible (⭐139), bugs probables sur les sources exotiques
+
+## Ressources
+
+- [GitHub diogovalentte/mantium](https://github.com/diogovalentte/mantium)
+- [selfh.st Books](https://selfh.st/apps/?tag=books)
+- [Démo de l'API (issue tracker)](https://github.com/diogovalentte/mantium/issues)
+
+## Pages Liées
+
+- [[cat-books]] — Catégorie Books
+- [[app-bookwyrm]] — Alternative livres « classiques » avec réseau social
+- [[app-komga]] — Lecteur comics/manga avec OPDS
+- [[app-stump]] — Alternative Rust
+- [[recettes-docker-compose]] — Templates Docker
+- [[app-homarr]] — Dashboard qui peut embarquer l'iFrame Mantium