wiki/Catalogue-Self-Hosted/apps/app-mantium.md

---
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