Files
2026-06-09 18:40:21 +02:00

5.8 KiB


title: Teemii created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, books, manga, comics, reader, scraper, vue, nodejs, docker] confidence: medium contested: false sources: [https://selfh.st/apps/?tag=books, https://github.com/dokkaner/teemii, https://www.teemii.io/]

📖 Teemii

Lecteur de manga auto-hébergé avec agrégateur de métadonnées multi-sources : importez vos archives CBZ/CBR, récupérez automatiquement les métadonnées depuis AniList/MangaDex/Kitsu, lisez dans le navigateur et synchronisez votre progression.

📋 Informations Générales

Champ Valeur
Site web teemii.io
GitHub dokkaner/teemii
Licence MIT
Langage JavaScript (Node.js), Vue 3, TailwindCSS
Étoiles GitHub 542
Dernière MAJ 2024-01 (v0.8.2)
Catégorie cat-books

📝 Description

Teemii est une application web taillée pour les amateurs de manga, comics et webtoons qui veulent une expérience unifiée de lecture dans le navigateur. Le projet se positionne à la croisée de Kavita (gestionnaire de bibliothèque) et de HakuNeko (lecteur/scraper) : Teemii propose à la fois la gestion d'archives locales (CBZ/CBR) et la récupération de chapitres depuis des sources en ligne (MangaDex, Bato, Comick, MangaKakalot, MangaPill, MangaUpdates, AniList, Kitsu, MyAnimeList).

L'agrégateur de métadonnées est le point fort : ajoutez un manga par nom, Teemii interroge plusieurs sources en parallèle, fusionne les informations, dédoublonne les entrées et présente une fiche unique avec synopsis, genres, auteurs, status de publication, couverture HD. Le scrobbler intégré synchronise votre progression avec Kitsu et AniList — vous lisez dans Teemii, votre profil AniList se met à jour tout seul.

Le lecteur web supporte les modes vertical (webtoon) et paginé (manga traditionnel), avec thèmes clair/sombre, zoom, et mémoire de la dernière page lue. Côté technique, l'application est découpée en deux services Docker : teemii-backend (API Node.js) et teemii-frontend (SPA Vue servie par Nginx), orchestrés par un docker-compose.yml officiel.

Points forts : agrégation multi-sources, scrobbling AniList/Kitsu, CBZ/CBR, mode sombre/clair, interface Vue soignée, MIT license.

Points faibles : projet jeune (auteur unique, commits rares depuis 2024), pas d'application mobile native, pas d'OPDS, pas de compatibilité avec les catalogues Calibre, communauté restreinte (47 forks), documentation minimaliste.

🚀 Installation

Option recommandée : Docker Compose

Le dépôt officiel fournit un docker-compose.yml qui démarre le backend (Node.js) et le frontend (Vue/Nginx) ensemble.

# docker-compose.yml
services:
  teemii-backend:
    image: ghcr.io/dokkaner/teemii-backend:latest
    container_name: teemii-backend
    restart: unless-stopped
    environment:
      - NODE_ENV=production
      - PORT=4000
      - DATABASE_URL=sqlite:///data/teemii.db
      - JWT_SECRET=change-me-strong-secret
    volumes:
      - teemii_data:/app/data
      - teemii_manga:/manga
    ports:
      - "4000:4000"

  teemii-frontend:
    image: ghcr.io/dokkaner/teemii-frontend:latest
    container_name: teemii-frontend
    restart: unless-stopped
    environment:
      - VITE_API_URL=http://teemii-backend:4000
    ports:
      - "8080:80"
    depends_on:
      - teemii-backend

volumes:
  teemii_data:
  teemii_manga:

Installation manuelle

Cloner le dépôt, cd app && npm install && npm run build pour le frontend, cd server && npm install && npm start pour le backend. Prévoir Node.js 20+, npm/yarn, et un reverse-proxy pour la mise en production.

⚙️ Configuration Initiale

  1. Définir JWT_SECRET (long, aléatoire) pour signer les sessions.
  2. Monter le volume /manga sur votre dossier d'archives CBZ/CBR.
  3. Lancer un scan de la bibliothèque (bouton UI ou tâche cron).
  4. Connecter AniList/Kitsu dans les préférences utilisateur pour activer le scrobbling (token OAuth à fournir).
  5. Activer HTTPS via reverse proxy (Caddy/Nginx) si accès distant.
  6. Configurer la sauvegarde du volume teemii_data (SQLite + cache).

🔄 Alternatives

Open Source

  • app-kavita — Gestionnaire de comics/manga/library, plus mature
  • HakuNeko — Lecteur de manga desktop multi-sources
  • Mango — Lecteur minimaliste manga
  • Komga — Spécialisé comics/BD, serveur OPDS
  • Suwayomi — Serveur manga Tachiyomi headless

Propriétaires

  • Tachiyomi / Mihon (Android) — Lecteur de référence, mais mobile
  • Manga Plus (SHUEISHA) — Officiel, mais fermé
  • Crunchyroll Manga — Vaste catalogue, freemium

🔐 Sécurité

  • Authentification JWT sur l'API (token côté frontend)
  • ⚠️ Scraper intégré : respecter les robots.txt et les rate-limits des sources
  • HTTPS obligatoire via reverse proxy
  • Volumes nommés pour persistance et sauvegardes
  • ⚠️ Mono-instance recommandée (auteur unique, pas de clustering)
  • Pas de télémétrie, pas de tracking
  • ⚠️ API non documentée : intégrer d'autres clients à vos risques

📚 Ressources

Pages Liées