Français

Introduction

Bookscout est une application complète de gestion de bibliothèque personnelle pour macOS et iOS. Elle vous aide à organiser votre collection de livres, collecter des citations mémorables et interagir avec un assistant IA pour enrichir votre expérience de lecture.

Démarrage

Interface Principale

L'interface de Bookscout est organisée en plusieurs sections accessibles depuis la barre latérale :

• Livres : Gérez votre collection de livres
• Citations : Organisez vos citations favorites
• Assistant IA : Posez des questions sur votre bibliothèque
• Paramètres : Personnalisez l'application

Gérer les Livres

Ajouter un Livre

Saisie Manuelle :

• Cliquez sur le bouton "+" dans la barre d'outils de la vue Livres
• Remplissez les détails du livre : Titre (requis), Auteur, ISBN, Genre, Langue, Résumé, Date de publication, Note, Statut de lecture
• Optionnellement, ajoutez une image de couverture
• Cliquez sur "Enregistrer"

Scanner de Code-Barres ISBN :

• Cliquez sur l'icône du scanner de code-barres dans la barre d'outils
• Pointez votre caméra vers le code-barres ISBN du livre
• Les informations du livre sont automatiquement récupérées depuis les bases de données en ligne
• Révisez et enregistrez le livre dans votre bibliothèque

Importer depuis un Fichier :

• Allez dans Paramètres > Données > Importer des Livres
• Sélectionnez un fichier de sauvegarde JSON
• Révisez les résultats d'importation montrant le nombre de livres importés, ignorés (doublons) et les erreurs éventuelles

Visualiser Vos Livres

Basculez entre deux modes d'affichage en utilisant le bouton dans la barre d'outils :

• Vue Grille : Couvertures visuelles en grille - parfait pour parcourir votre collection
• Vue Liste : Format de liste compact montrant le titre, l'auteur et le statut - idéal pour un balayage rapide

Recherche et Filtrage

Recherche Rapide :

• Tapez dans la barre de recherche pour trouver des livres par titre, auteur ou ISBN
• Les résultats de recherche se mettent à jour en temps réel pendant que vous tapez

Filtres Avancés :

• Statut de Lecture : Filtrer par À Lire, En Cours, Terminé ou Abandonné
• Genre : Afficher les livres de genres spécifiques
• Langue : Filtrer par langue
• Note : Définir un filtre de note minimum (1-5 étoiles)
• Plage de Dates : Filtrer les livres par date d'ajout

Options de Tri :

• Titre (A-Z)
• Date d'ajout (plus récent en premier)
• Statut de lecture
• Note (plus élevée en premier)

Organiser Votre Bibliothèque

Statut de Lecture : Suivez votre progression de lecture avec quatre statuts :

• À Lire : Livres dans votre liste de lecture
• En Cours : Actuellement en train de lire
• Terminé : Livres complétés
• Abandonné : Livres que vous avez arrêtés de lire

Notes : Notez les livres de 1 à 5 étoiles pour suivre vos favoris et vous souvenir des livres que vous avez le plus appréciés.

Genres : Catégorisez les livres par genre pour une meilleure organisation et une découverte plus facile.

Modifier et Supprimer des Livres

• Appuyez sur un livre pour voir ses détails
• Appuyez sur le bouton Modifier pour modifier toute information
• Supprimez des livres en utilisant l'option de suppression (les citations associées peuvent être conservées ou supprimées)

Exporter des Livres

• Allez dans Paramètres > Données > Exporter des Livres
• Choisissez l'emplacement de sauvegarde
• Le fichier est enregistré avec horodatage : bookscout_books_YYYY-MM-dd_HH-mm-ss.json
• Utilisez ce fichier pour sauvegarder ou transférer votre bibliothèque

Bibliothèques

Organiser plusieurs bibliothèques

Vous pouvez créer plusieurs bibliothèques pour organiser vos livres — par exemple par lieu, par thème ou par membre de la famille. Une bibliothèque par défaut « Ma Bibliothèque » est créée automatiquement. Il est impossible de supprimer la dernière bibliothèque restante.

Créer et personnaliser une bibliothèque

Depuis Paramètres > Données > Gérer les bibliothèques (ou le sélecteur en haut de la vue Livres) :

• Créez une nouvelle bibliothèque avec un nom, une icône et une couleur
• Renommez ou personnalisez l'icône/couleur d'une bibliothèque existante
• Sélectionnez une bibliothèque pour filtrer la vue Livres, ou choisissez « Toutes les bibliothèques »
• Consultez le nombre de livres par bibliothèque

Déplacer un livre entre bibliothèques

Choisissez ou changez la bibliothèque d'un livre directement depuis son formulaire d'ajout ou de modification.

Supprimer une bibliothèque

Si vous supprimez une bibliothèque, ses livres ne sont jamais supprimés — ils sont automatiquement déplacés vers une autre bibliothèque existante.

Synchronisation entre appareils

Vos bibliothèques se synchronisent automatiquement via iCloud sur tous vos appareils Apple, comme le reste de votre collection. Si deux appareils créent chacun leur propre bibliothèque par défaut avant que la synchronisation n'ait rattrapé son retard, Bookscout fusionne automatiquement les doublons en une seule au lancement suivant — aucun livre n'est jamais perdu dans ce processus.

Gérer les Citations

Créer des Citations

Saisie Manuelle :

• Ouvrez la vue Citations et appuyez sur le bouton "+"
• Entrez le texte de la citation
• Optionnellement, liez-la à un livre de votre bibliothèque
• Ajoutez le numéro de page, le nom de l'auteur ou des notes pour le contexte
• Enregistrez la citation

Depuis l'Assistant IA :

• Dans l'Assistant IA, obtenez une réponse
• Appuyez sur "Ajouter au Livre" sur le message
• Sélectionnez le livre cible
• La citation est automatiquement sauvegardée dans votre collection

Visualiser les Citations

Basculez entre deux modes d'affichage :

• Vue Grille : Cartes de citations visuelles avec aperçu du texte et livre associé
• Vue Liste : Format compact montrant le texte complet de la citation et le livre source

Rechercher et Organiser les Citations

Recherche : Utilisez la barre de recherche pour trouver des citations par contenu - recherchez instantanément dans toutes vos citations sauvegardées.

Filtrer par Livre : Consultez toutes les citations d'un livre spécifique - les citations sont automatiquement liées lorsque vous les associez à des livres.

Filtrer par Auteur : Filtrez les citations par l'auteur du livre source pour voir toutes les citations de vos auteurs favoris.

Modifier et Gérer les Citations

• Appuyez sur une citation pour voir tous les détails
• Modifiez le texte de la citation ou les métadonnées
• Supprimez les citations dont vous n'avez plus besoin

Importer et Exporter des Citations

Exportation :

• Allez dans Paramètres > Données > Exporter des Citations
• Choisissez l'emplacement de sauvegarde
• Le fichier est enregistré avec horodatage : bookscout_quotes_YYYY-MM-dd_HH-mm-ss.json

Importation :

• Allez dans Paramètres > Données > Importer des Citations
• Sélectionnez un fichier de sauvegarde JSON
• Révisez les résultats d'importation (importées, ignorées, erreurs)

Partager une Citation

Depuis l'écran de détail d'une citation, appuyez sur le bouton de partage pour générer une carte image stylisée (texte, auteur et livre source) et la partager via le menu de partage natif — réseaux sociaux, messages, etc. La carte est générée localement sur votre appareil.

Raccourcis et Widget

Siri, Spotlight et l'app Raccourcis

Bookscout propose deux raccourcis système :

• « Ajouter un livre par ISBN » : ouvre directement le scanner ISBN (iPhone/iPad) ou le panneau de recherche ISBN (Mac)
• « Demander à l'assistant IA » : ouvre l'Assistant IA, clavier prêt

Déclenchez-les via Siri, la recherche Spotlight, ou en les ajoutant à un raccourci personnel dans l'app Raccourcis d'Apple.

Widget d'écran d'accueil

Ajoutez le widget Bookscout à votre écran d'accueil (iPhone/iPad ; pas encore disponible sur Mac) en formats petit ou moyen. Il affiche votre livre en cours de lecture (ou votre dernière citation à défaut), ainsi que le nombre total de livres et de citations. Le widget se met à jour automatiquement à chaque ouverture de l'app.

Assistant IA

Démarrage

Bookscout inclut un assistant IA puissant qui peut vous aider à :

• Répondre aux questions sur votre collection
• Trouver les livres que vous avez lus cette année
• Obtenir des recommandations de livres
• Explorer les statistiques de votre bibliothèque
• Analyser vos habitudes de lecture

RAG (Retrieval-Augmented Generation)

Bookscout dispose d'un système RAG avancé qui améliore les réponses de l'IA en recherchant dans votre bibliothèque :

Qu'est-ce que le RAG ?

Le RAG (Retrieval-Augmented Generation) permet à l'IA de rechercher dans vos livres et citations pour fournir des réponses plus précises et contextuellement pertinentes. Lorsque le RAG est activé, l'IA :

• Recherche dans votre bibliothèque des informations pertinentes avant de répondre
• Utilise à la fois la recherche sémantique (compréhension du sens) et la recherche par mots-clés (correspondances exactes)
• Combine les informations de plusieurs sources (livres, citations, métadonnées)
• Fournit des réponses basées sur votre collection réelle

Comment Utiliser le RAG :

• Activez/désactivez le RAG en utilisant l'icône de loupe dans la barre de saisie
• Lorsqu'il est activé (icône bleue), l'IA recherchera dans votre bibliothèque avant de répondre
• Lorsqu'il est désactivé (icône grise), l'IA répond en utilisant uniquement ses connaissances générales

Modes de Recherche RAG :

• Mode Simple : Recherche dans les métadonnées des livres, résumés et citations - plus rapide et utilise moins de contexte
• Le RAG combine la recherche vectorielle (similarité sémantique) avec la recherche par mots-clés pour de meilleurs résultats

Quand Utiliser le RAG :

• Questions sur votre collection spécifique ("Quels livres ai-je lus cette année ?")
• Trouver des informations provenant de vos livres ("Qu'ai-je appris sur [sujet] ?")
• Obtenir des recommandations basées sur votre historique de lecture
• Analyser les tendances dans votre bibliothèque

Quand Désactiver le RAG :

• Questions générales qui ne nécessitent pas vos données de bibliothèque
• Réponses plus rapides lorsque vous n'avez pas besoin du contexte de la bibliothèque

Configuration des Fournisseurs IA

Allez dans Paramètres > Fournisseurs IA pour configurer votre service IA préféré :

Gemini (Google) :

• Obtenez une clé API depuis Google AI Studio
• Entrez-la dans Paramètres
• Sélectionnez le modèle
• Testez la connexion

OpenAI :

• Obtenez une clé API depuis OpenAI
• Entrez-la dans Paramètres
• Choisissez le modèle (GPT-3.5 ou GPT-4)
• Testez la connexion

Mistral :

• Obtenez une clé API depuis Mistral AI
• Entrez-la dans Paramètres
• Sélectionnez le modèle
• Testez la connexion

Anthropic :

• Obtenez une clé API depuis la Console Anthropic
• Entrez-la dans Paramètres
• Sélectionnez le modèle
• Testez la connexion

Ollama (macOS uniquement) :

• Installez Ollama sur votre Mac
• Définissez l'URL de l'hôte (par défaut : http://localhost:11434)
• Aucune clé API nécessaire
• Exécutez les modèles localement pour une confidentialité complète

Utiliser l'Assistant IA

Cas d'Usage Courants :

• "Quels livres ai-je lus cette année ?"
• "Montre-moi tous les livres de science-fiction"
• "Quelle est ma note moyenne de lecture ?"
• "Recommande des livres similaires à [titre]"
• "Que devrais-je lire ensuite ?"
• "Trouve des citations sur [sujet]"

Ajouter des Citations depuis l'IA :

• Obtenez une réponse IA utile
• Appuyez sur le bouton "Ajouter au Livre" sur le message
• Sélectionnez le livre cible
• La citation est sauvegardée automatiquement

Paramètres

Apparence

Thèmes : Choisissez parmi plusieurs thèmes :

• Système : Correspond automatiquement à l'apparence de votre appareil
• Clair : Interface lumineuse et épurée
• Sombre : Réduit la fatigue oculaire, meilleur pour la lecture en faible luminosité
• Sépia : Tons chauds, style papier
• Contraste Élevé : Visibilité améliorée et accessibilité
• Voyelles : Thème artistique spécial avec fond manuscrit

Densité : Contrôlez l'espacement dans l'interface :

• Compact : Plus de contenu visible
• Normal : Mise en page équilibrée
• Spacieux : Espacement confortable

Localisation

Langue : Basculez entre Anglais et Français. L'interface se met à jour immédiatement lorsque vous changez la langue.

Configuration des Fournisseurs IA

Configurez vos fournisseurs d'assistant IA, clés API et modèles. Testez les connexions pour vous assurer que tout fonctionne correctement.

Synchronisation

Synchronisation iCloud :

• Activez la synchronisation CloudKit
• Accédez à votre bibliothèque sur tous vos appareils Apple (Mac, iPhone, iPad)
• Sauvegarde et synchronisation automatiques
• Toutes les données sont cryptées et sauvegardées en toute sécurité sur iCloud

Rappels

Activez un rappel de notification local optionnel (désactivé par défaut). Un seul rappel discret est programmé environ tous les 30 jours, avec un résumé du nombre de livres ajoutés récemment. Ne nécessite pas d'autorisation supplémentaire — la permission déjà accordée pour la synchronisation iCloud est réutilisée.

Gestion des Données

Gestion du Cache :

• Ajustez la taille du cache mémoire
• Videz le cache d'images
• Libérez de l'espace de stockage

Import/Export : Sauvegardez toute votre bibliothèque avec l'export JSON. Importez des livres et des citations depuis des sauvegardes pour garantir que vos données sont toujours sûres et portables.

Suppression : Videz les données locales (supprime uniquement de l'appareil) ou videz les données CloudKit (supprime de tous les appareils).

Confidentialité

• Les clés API sont stockées en toute sécurité dans le trousseau
• Les données locales restent sur votre appareil
• Les données CloudKit sont cryptées par Apple

Crédits

Le thème "Voyelles" utilise une image de fond du manuscrit du poème "Voyelles" (1871-1872) d'Arthur Rimbaud. Cette image est utilisée sous la licence Creative Commons Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0).

Attribution de l'image :

• Auteur : Siren-Com
• Source : Wikimedia Commons
• Licence : CC BY-SA 3.0
• Description : Fac-similé du manuscrit autographe du poème "Voyelles" de Rimbaud du Musée Rimbaud de Charleville-Mézières, photographié lors de l'exposition "Rimbaudmania" à Paris.