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,130 @@
+---
+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](https://www.teemii.io/) |
+| **GitHub** | [dokkaner/teemii](https://github.com/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.
+
+```yaml
+# 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
+
+- [Site officiel](https://www.teemii.io/)
+- [Documentation Quick-Start](https://docs.teemii.io/Quick-Start/)
+- [GitHub dokkaner/teemii](https://github.com/dokkaner/teemii)
+- [Reddit r/selfhosted — Teemii announcement](https://www.reddit.com/r/selfhosted/comments/18x1l9p/)
+
+## Pages Liées
+
+- [[cat-books]] — Catégorie Books
+- [[app-kavita]] — Lecteur comics/BD/Manga, alternative mature
+- [[app-komga]] — Serveur OPDS pour BD/manga
+- [[app-caddy]] — Reverse proxy HTTPS
+- [[recettes-docker-compose]] — Templates Docker