Fiche de lecture — extension calibre (Gemini / Claude Code)

Une fiche de lecture complète — introduction, résumé chapitre par chapitre, analyse critique — pour n'importe quel livre de votre bibliothèque calibre, en un clic.

👉 Découvrir le site de présentation · Télécharger la dernière version

L'extension découpe le livre sélectionné en chapitres d'après sa table des matières, fait résumer chaque chapitre par une IA, puis rédige une introduction et une analyse critique. Le résultat est enregistré en Markdown, HTML et EPUB 3, ajouté à votre bibliothèque comme un livre (« Titre — Fiche de lecture ») et ouvert dans la liseuse de calibre.

Deux moteurs au choix :

• Google Gemini — API, clé gratuite à créer sur Google AI Studio ;
• Claude Code — la CLI claude installée sur votre ordinateur, avec le compte déjà connecté : aucune clé à saisir.

---

Sommaire

• Fonctionnalités
• Installation
• Configuration des moteurs
• Langues
• Fonctionnement
• Compiler depuis les sources
• Limites
• English summary
• Licence

Fonctionnalités

La fiche contient :

1. Introduction : présentation, résumé d'ensemble, thèmes, personnages ou notions clés ;
2. Résumé chapitre par chapitre ;
3. Analyse critique : points forts, limites, style, portée, public visé, appréciation.

Et autour :

• 📚 Formats EPUB, KEPUB et AZW3 ; découpage d'après la table des matières (profondeur réglable).
• 🔎 Prévisualiser le découpage avant de consommer du quota.
• ⚙️ Tâche de fond calibre : annulable, progression visible dans la liste des tâches.
• 💾 Cache des réponses : si la génération échoue au chapitre 30, la relance repart de là.
• 📖 Trois formats de sortie : HTML (écran), Markdown (édition), EPUB 3 (liseuse, avec table des matières).
• 🗂️ Livre-fiche ajouté à la bibliothèque et ouvert dans la liseuse ; une régénération le remplace.
• ✍️ Prompts modifiables dans les réglages.
• 🌍 Interface en anglais et en français ; fiche en français, anglais, espagnol, allemand, italien, portugais… ou toute autre langue saisie librement.

Installation

1. Téléchargez fiche_lecture_gemini.zip depuis la page Releases (ne le décompressez pas).
2. Dans calibre : Préférences ▸ Extensions ▸ Charger une extension depuis un fichier, puis choisissez le zip.
3. Redémarrez calibre.
4. Si le bouton « Fiche de lecture » n'apparaît pas, ajoutez-le à la barre d'outils : Préférences ▸ Barres d'outils et menus.

Ensuite : sélectionnez un livre, cliquez sur Fiche de lecture. Le menu déroulant du bouton propose aussi « Générer avec Gemini », « Générer avec Claude Code », « Régénérer sans utiliser le cache », « Ouvrir la fiche dans la liseuse », « Prévisualiser le découpage » et « Configurer… ».

Version minimale : calibre 6.18 (Windows, macOS, Linux).

Configuration des moteurs

	Gemini	Claude Code
Authentification	clé API (réglages ou variable GEMINI_API_KEY)	compte déjà connecté dans Claude Code
Modèle	gemini-2.5-flash par défaut, bouton « Lister les modèles »	sonnet par défaut (opus, haiku, nom complet)
Appel	REST generateContent	claude -p --tools "" --system-prompt … --output-format json, texte sur stdin, dossier temporaire vide

• Gemini : créez une clé sur https://aistudio.google.com/apikey et collez-la dans la configuration de l'extension. Le bouton « Lister les modèles » vérifie la clé. L'intervalle entre requêtes et les nouvelles tentatives (429/5xx) respectent le quota.
• Claude Code : rien à configurer si la CLI claude est installée et connectée. Elle est détectée automatiquement (PATH, ~/.local/bin, ~/.claude/local, Homebrew, npm…) ; un chemin peut être forcé dans les réglages. Claude est appelé sans aucun outil, dans un dossier temporaire vide.
• Le moteur Automatique choisit Gemini si une clé est configurée, sinon Claude Code s'il est détecté.

Langues

Deux réglages indépendants :

• Langue de l'interface (menus, réglages, messages, journal des tâches) : elle suit celle de calibre. Les textes source sont en anglais, avec une traduction française (plugin/translations/fr.po).
• Langue de la fiche (onglet Sortie) : par défaut, celle de l'interface. En français, anglais, espagnol, allemand, italien et portugais, elle traduit les titres de la fiche (« Reading Notes », « Critical analysis »…), l'étiquette et le titre du livre-fiche, le nom des fichiers, l'attribut de langue de l'EPUB et les prompts. On peut aussi saisir une autre langue (« Nederlands », « 日本語 ») : les prompts et titres anglais sont alors utilisés, et la rédaction est demandée dans cette langue.
• Les prompts non modifiés suivent la langue de la fiche. Un prompt modifié est conservé tel quel.

Pour ajouter une langue d'interface : cp plugin/translations/messages.pot plugin/translations/de.po, traduire, puis ./build.sh. Après une modification des textes dans le code, ./build.sh --pot met à jour le modèle et les .po.

This is the beginning of the README. Read the rest at the original. Read the full README ↗