- Python 41.3%
- HTML 26.1%
- JavaScript 22.8%
- CSS 8%
- Batchfile 0.8%
- Other 1%
| __pycache__ | ||
| data | ||
| scrapers | ||
| static | ||
| templates | ||
| views | ||
| .env.example | ||
| app.py | ||
| build.bat | ||
| build_debug.bat | ||
| config.py | ||
| docker-compose.yml | ||
| Dockerfile | ||
| entrypoint.sh | ||
| logo.ico | ||
| README.md | ||
| requirements.txt | ||
| requirements_windows.txt | ||
GenBook
GenBook est un outil tout-en-un, conçu à l'origine pour automatiser et normaliser la création de NFO et la génération de BBcode pour le partage de fichiers (Manga, BD, Romans). L'interface offre un scrapper efficace permettant d'aller chercher directement les métadonnées (titre, synopsis, auteur, ISBN, dimensions, etc.) auprès d'un large choix de bases de données de référence :
- Manga : Nautiljon, MyAnimeList (Jikan), AniList, MangaDex.
- BD / Comics : Metron, ComicVine, Bédéthèque, BDThèque, Inventaire, BnF.
- Livres / Romans : OpenLibrary, Google Books, Gutendex (Projet Gutenberg), Catalogue BnF.
Il inclut également des extracteurs natifs pour extraire les données et les dimensions d'image automatiquement à l'upload d'un fichier (CBZ, EPUB, PDF ou format image standard).
Le projet tire parti d'un back-end en Flask combiné avec FlaskWebGUI pour une présentation fluide aussi bien sur navigateur (via Docker) que sous format application Desktop autonome sous Windows.
🛠️ Déploiement via Docker (Recommandé pour Serveurs / NAS)
Le mode de déploiement Docker vous donnera une version "web-based" tournant sur conteneur. Toutes les données utilisateur, les réglages et les historiques sont persistés localement via un volume.
Prérequis
- Docker
- Docker Compose
Lancement
- Clonez ce dépôt.
- (Optionnel) Pour pré-configurer vos clés API, copiez le fichier
.env.exampleen.envet remplissez vos identifiants à l'intérieur :cp .env.example .env - Pour lancer le projet, exécutez la commande suivante à la racine :
docker compose up -d --build - L'application web est maintenant accessible via votre navigateur sur
http://localhost:5000.
Gestion des Données
Le dossier ./data à la racine de votre dossier projet sera peuplé après le premier démarrage (monté en tant que volume persistant) :
bbcode_templates/: pour créer et gérer vos templates BBcode personnalisables.nfo_templates/: pour vos templates au format de fichier .nfo.config.jsonethistory.json: contiennent respectivement vos clés API (si configurées via le menu ⚙️ de l'interface) et l'historique complet de tous les fichiers et descriptions déjà générés.
💻 Build Windows Exécutable Standalone (Application de Bureau)
Pour un usage purement local sous Windows en tant que petite application de Bureau portable, le projet intègre des scripts de build grâce à PyInstaller et FlaskWebGUI.
Prérequis
- Python (idéalement Python 3.10 ou environnements similaires) fonctionnel sous Windows.
Installation et Build
- Environnement virtuel : Il est très fortement conseillé de déployer un environnement virtuel propre avant l'installation sous Windows.
Dans un terminal à la racine du projet (ex: PowerShell ou CMD) :
python -m venv venv .\venv\Scripts\activate - Installation des dépendances : Vous DEVEZ utiliser le fichier Windows pour les requirements et non celui standard.
pip install -r requirements_windows.txt - Construction du binaire (.exe) : Lancez simplement notre script d'automatisation.
build.bat
Une fois validé, vous trouverez le dossier exécutable et complet dans le répertoire dist/GenBook/. Le résultat est un GenBook.exe portable comportant sa propre interface de bureau générée par le micro-navigateur interne.