Files
wiki/Catalogue-Self-Hosted/apps/app-mantium.md
T
2026-06-09 18:40:21 +02:00

6.4 KiB


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
GitHub 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).

# 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

Pages Liées