Sous le capot
Où vivent vos livres, comment l'iPhone et le Mac se parlent, ce qui sort sur Internet et ce qui n'en sort jamais.
Où vit votre bibliothèque ?
L’iPhone
- L’app L’appareil photo, le scanner, la dictée. La bibliothèque, les fiches, le classement.
- Le moteur Le seul à lire et écrire la base. Il analyse les photos et interroge les catalogues ; sans IA réglée, Apple Intelligence lit les couvertures, sur l’iPhone.
- Le dossier La base de données (
colophon.db) et vos images : photos, couvertures, originaux, sommaires.
Les catalogues
Livres BnF, Open Library, Google Books avec une clé
Albums MusicBrainz, Cover Art Archive
Films TMDB
Revues Wikidata
Une IA, si vous voulez
Claude ou OpenAI, avec votre clé.
Ou Ollama, sur votre Mac : rien ne sort.
Vos autres appareils
Si vous l’allumez : la même bibliothèque sur l’iPhone, l’iPad et le Mac, par votre iCloud Drive.
La sauvegarde
Le fichier « Couvertures iPhone », dans iCloud Drive › Couvertures ou un dossier choisi. Un Mac le reprend d’un double-clic.
Le Mac
- L’app La fenêtre, les menus, les réglages.
- Le serveur La porte du moteur. Il répond à l’iPhone, à l’autre téléphone, et à la fenêtre du Mac elle-même.
- Le moteur Le seul à lire et écrire la base. Il analyse les photos et interroge les catalogues ; sans IA réglée, Apple Intelligence lit les couvertures, sur le Mac.
- Le dossier La base de données (
colophon.db) et vos images : photos, couvertures, originaux, sommaires.
L’iPhone et l’iPad
L’appareil photo, le scanner, la dictée. Une copie de la bibliothèque, pour la parcourir loin du Mac, et ce qui attend d’être envoyé.
Un autre téléphone
Android, ou celui d’un proche : la page web du Mac, ouverte par le QR code.
Les catalogues
Livres BnF, Open Library, Google Books avec une clé
Albums MusicBrainz, Cover Art Archive
Films TMDB
Revues Wikidata
Une IA, si vous voulez
Claude ou OpenAI, avec votre clé.
Ou Ollama, sur votre Mac : rien ne sort.
Vos autres appareils
Si vous l’allumez : la même bibliothèque sur l’iPhone, l’iPad et le Mac, par votre iCloud Drive.
La sauvegarde
Le fichier « Couvertures Mac », dans un dossier de votre choix : iCloud Drive, Dropbox, un disque, un NAS.
Un dossier garde tout
Votre bibliothèque est un dossier : sur le Mac, à l’endroit que vous avez choisi, ou dans l’app, sur l’iPhone. Dedans :
colophon.db, la base de données : un seul fichier au format SQLite, celui qu’utilisent presque tous les téléphones et les navigateurs. On y trouve chaque livre, revue, film ou album, son classement, vos notes, vos lectures, et les réglages de la bibliothèque (catégories, emplacements, listes).photos, vos photos, recadrées et allégées ;covers, les couvertures, affiches et pochettes trouvées en ligne et retenues ;originals, vos photos en grand, pour pouvoir les recadrer ou les relire plus tard ;contents, les photos du sommaire de vos revues.
La base ne retient que le nom de chaque image, jamais son chemin complet : le dossier peut changer de place, de disque ou d’appareil sans rien casser. Son format est ouvert : tout logiciel qui lit SQLite peut l’ouvrir ; l’ancien nom de l’app, Colophon, y est resté.
Un moteur, sur l’iPhone ou sur le Mac
Le cœur de Couvertures est un moteur : lui seul lit et écrit la base, analyse les photos et interroge les catalogues. Les écrans ne touchent jamais la base eux-mêmes : ils lui demandent. C’est le même moteur sur l’iPhone et sur le Mac, avec les mêmes règles.
Il tourne là où vit la bibliothèque, choisi au premier lancement de l’iPhone (Où vit votre bibliothèque ?) et modifiable dans Réglages > Où vit la bibliothèque :
- Sur cet iPhone : le moteur tourne dans l’app de l’iPhone, qui s’adresse à lui directement, sans serveur ni réseau local. Il n’a pas besoin d’un Mac.
- Sur mon ordinateur : le moteur tourne dans l’app du Mac, et l’iPhone lui parle par le Wi-Fi. Les trois sections qui suivent décrivent ce chemin-là.
Passer de l’un à l’autre n’efface rien : chaque mode garde sa bibliothèque. Pour emmener la bibliothèque de l’iPhone sur le Mac, on passe par sa sauvegarde (plus bas) ; pour avoir la même sur plusieurs appareils, par la synchronisation (plus bas aussi).
Avec un Mac, un petit serveur
Quand la bibliothèque vit sur le Mac, Couvertures y fait tourner un serveur web, comme un site qui ne serait visible que chez vous. Il est la porte du moteur. Tout lui parle : l’iPhone, la page web d’un autre téléphone (ouverte par le QR code des Réglages du Mac), et même la fenêtre du Mac, qui passe par la même porte que les autres. Un seul gardien : deux écrans ne peuvent pas modifier un livre en même temps et se marcher dessus.
Le serveur tourne tant que l’app est ouverte, même fenêtre fermée. C’est pour cela que l’iPhone, pour envoyer ses photos, demande le Mac allumé, réveillé, et Couvertures pas quitté.
Comment l’iPhone trouve le Mac
Le Mac s’annonce sur le Wi-Fi par Bonjour, le procédé d’Apple qui fait apparaître une imprimante ou une Apple TV sans rien régler : « Couvertures est ici, sur tel Mac ». L’iPhone écoute, et retient le nom du Mac plutôt que son adresse, qui peut changer d’un jour à l’autre.
Ensuite, ils parlent HTTP, la langue du web, directement d’un appareil à l’autre, sans passer par Internet. La conversation n’est pas chiffrée : elle reste sur votre réseau, comme celle d’une imprimante. Sur un Wi-Fi public (train, café, hôtel), décochez Accessible depuis le Wi-Fi dans les Réglages du Mac : le serveur refuse alors tout ce qui ne vient pas du Mac lui-même.
Si le réseau cache les appareils (certains Wi-Fi d’entreprise ou d’hôtel), on tape l’adresse du Mac à la main : voir Commencer.
Loin du Mac
À chaque connexion, l’iPhone reçoit la bibliothèque du Mac et en garde une copie : tous les textes, et la couleur de chaque couverture. Les images, seulement si vous le demandez (Réglages, « Garder les couvertures sur ce téléphone ») : elles se copient alors une à une, sans gêner la bibliothèque. Loin du Mac, l’iPhone montre ainsi toute la bibliothèque et répond à « Est-ce que je l’ai déjà ? » en librairie.
Ce que vous faites loin du Mac attend sur l’iPhone, puis part au retour :
- les photos et les codes-barres scannés. Les photos attendent dans une file d’envoi : l’iPhone réessaie régulièrement, et iOS continue l’envoi même quand l’app est en arrière-plan. Une photo ne quitte la file qu’une fois que le Mac a répondu qu’il l’a bien reçue ;
- les fiches modifiées, champ par champ. Si le Mac n’a pas touché ce champ entre-temps, la modification passe sans rien demander. S’il l’a changé lui aussi, l’iPhone demande laquelle garder (Modifié des deux côtés). Les mots-clés et les listes s’additionnent : aucun classement ne se perd.
La bibliothèque, elle, reste celle du Mac : l’iPhone en tient une copie, il ne la remplace pas.
D’une photo à une fiche
- Sur l’iPhone, le scanner d’Apple lit le code-barres en direct, sans rien envoyer ailleurs. Une photo de couverture peut être recadrée et éclaircie avant de partir (Recadrer) ; sinon, le moteur la recadre lui-même. Un titre dicté est transcrit par la reconnaissance vocale d’Apple, sur l’appareil. La quatrième de couverture est lue par Vision, la lecture de texte d’Apple, sur l’appareil aussi : ses lignes sont regroupées en paragraphes (les colonnes, les mots coupés en fin de ligne) sans IA, et seul le texte que vous gardez part au moteur.
- Le moteur reçoit la photo, la range parmi les « photos à traiter » et la réduit. Il en
garde une grande version dans
originals. - Il cherche. S’il trouve un code-barres sur la photo, il interroge les catalogues avec. Sinon, si vous avez réglé une IA, elle lit la couverture (titre, auteur, éditeur, et où se trouve l’objet sur la photo, pour le recadrer) ; sans IA réglée, c’est Apple Intelligence, sur l’appareil, et sa lecture est vérifiée mot à mot sur le texte que Vision, la lecture de texte d’Apple, trouve sur la photo. Les catalogues sont interrogés en même temps, et leurs réponses sont rangées de la plus probable à la moins probable.
- Vous validez. Rien n’entre dans la base avant ce moment-là, avec la couverture que vous avez gardée et le lot de la séance (« Caisse 4 »).
Un titre dicté suit le même chemin : l’IA comprend la phrase (« le Petit Prince de Saint-Exupéry chez Folio ») et répare les noms mal entendus, en s’aidant des auteurs déjà dans votre bibliothèque.
Le code-barres dit ce que l’on tient, et donc où chercher :
- Un livre : son ISBN, à la Bibliothèque nationale de France, à Open Library, et à Google Books si vous y avez mis une clé.
- Une revue : son code n’est pas un ISBN. Celui des revues françaises de kiosque porte un
code titre, que l’iPhone lit avec le numéro imprimé juste au-dessus ; celui des revues
étrangères, un ISSN, que Wikidata, la base ouverte de Wikipédia, sait nommer. La première fois,
l’IA lit le nom de la revue sur la couverture. Les photos du sommaire sont gardées dans
contents, et l’IA en tire la liste des articles, l’ours et quelques mots-clés. - Un film (DVD) : son code-barres, un EAN, à la BnF, qui connaît les DVD déposés en France. Le titre trouvé part ensuite chez TMDB, la base de films et de séries, pour l’affiche, le résumé et les genres.
- Un album (CD) : son EAN, à la BnF et à MusicBrainz, la base ouverte de la musique ; la Cover Art Archive, sa voisine, donne la pochette.
Sans code-barres, on photographie la couverture, la jaquette ou la pochette, ou l’on tape et dicte le titre. Dans Ajouter, sur l’iPhone et l’iPad, la barre Livres, Films, Musique dit au moteur où chercher : un film chez TMDB, un album chez MusicBrainz, un livre dans les catalogues.
Ce qui sort sur Internet
Seulement quand vous ajoutez ou cherchez quelque chose, que vous demandez des mots-clés, et seulement ceci :
- vers les catalogues publics (Bibliothèque nationale de France, Open Library, et Google Books si vous y avez mis une clé) : un ISBN ou un code-barres, ou un titre et un auteur ;
- vers MusicBrainz et la Cover Art Archive : le code-barres ou le titre d’un CD, pour le disque et sa pochette ;
- vers TMDB : le titre d’un film, pour son affiche, son résumé et ses genres ;
- vers Wikidata : l’ISSN d’une revue étrangère, pour trouver son nom ;
- vers l’IA, si vous en avez réglé une : la photo de la couverture, la phrase dictée, les photos d’un sommaire ; et, quand vous demandez des mots-clés, le texte d’un livre (titre, auteurs, résumé, quatrième de couverture, sommaire) avec la liste de vos mots-clés. Avec Claude ou OpenAI, elle part chez eux, avec votre propre clé. Avec Ollama, l’IA tourne sur votre Mac et rien ne sort. Sans IA réglée, Apple Intelligence lit la couverture sur l’appareil : la photo ne sort pas.
Et, une fois par jour, vers notre site : la demande du numéro de la dernière version de l’app, pour proposer la mise à jour ; rien d’autre ne l’accompagne.
Pas de compte, pas de serveur chez nous, pas de mesure d’audience : nous ne voyons rien passer. Voir aussi Confidentialité.
Plusieurs appareils, une même bibliothèque
Allumée dans les Réglages, la synchronisation donne la même bibliothèque à votre iPhone, votre iPad et votre Mac. Elle ne met pas la base dans iCloud : ce serait l’abîmer (voir la sauvegarde, plus bas). Chaque appareil garde sa propre base, entière, et ce sont les changements qui voyagent.
- Un nom commun. Chaque livre et chaque revue porte un identifiant, le même sur tous les appareils, à côté de son numéro local.
- Un journal tenu par la base. À chaque écriture, la base note elle-même l’heure du changement, champ par champ ; pour les mots-clés, les listes et les valeurs du classement, élément par élément. Une suppression laisse une trace.
- Un fichier par appareil. Dans votre iCloud Drive, dossier Couvertures › Synchronisation, chaque appareil écrit un seul fichier, le sien : ce qu’il sait, avec ces heures. Personne n’écrit le fichier d’un autre ; chacun lit ceux des autres. Les images vont dans une réserve à côté, sous leur nom.
- Une règle, la même partout. Pour un champ, le changement le plus récent gagne. Pour un mot-clé ou une valeur du classement, deux ajouts se réunissent, un retrait voyage. Un livre supprimé ne revient que s’il a été modifié ailleurs depuis. Comme la règle est la même sur tous les appareils, ils arrivent au même résultat, quel que soit l’ordre des échanges ; relire un fichier ne change rien.
Il n’y a pas de serveur entre vos appareils : iCloud Drive transporte des fichiers, c’est tout. Vos clés d’IA n’y sont jamais écrites. Les photos à valider y passent une fois analysées par l’appareil qui les a prises, avec leurs propositions ; validée sur deux appareils, une photo donne le même livre, parce que le livre prend l’identifiant de la photo.
La sauvegarde
La sauvegarde automatique copie la bibliothèque dans un dossier de votre choix : iCloud Drive, Dropbox, un disque, un NAS. Elle y apparaît comme un seul fichier, à l’icône de Couvertures : « Couvertures Mac », « Couvertures iPhone », « Couvertures iPad », un par appareil, pour qu’ils ne se mélangent pas. Seules les nouvelles images partent à chaque fois ; de la base, les dix dernières versions sont gardées. Dedans, la copie est elle-même une bibliothèque : Couvertures sait la reprendre telle quelle.
Le Mac sauvegarde au rythme choisi : chaque jour, chaque semaine ou chaque mois. L’iPhone, quand la bibliothèque vit chez lui, sauvegarde dans votre iCloud Drive, dossier Couvertures (ou dans un autre dossier choisi), quand vous quittez l’app après un changement. Toucher ce fichier dans l’app Fichiers, ou le double-cliquer dans le Finder, propose de le reprendre : c’est ainsi qu’une bibliothèque passe de l’iPhone au Mac, ou d’un iPhone à un autre.
La bibliothèque elle-même, en revanche, ne doit pas vivre dans un dossier synchronisé. La base
s’écrit par petites touches, sur trois fichiers à la fois (colophon.db et ses deux voisins,
-wal et -shm) ; un service de synchronisation qui en copierait un au milieu d’une écriture
pourrait l’abîmer. Les Réglages du Mac le signalent.
Plus tard, Windows et Android
Couvertures pour Windows et pour Android viendra plus tard. La version pour Windows est écrite dans une autre technique (une page web et Node.js), et ouvre le même dossier, sans conversion : une bibliothèque pourra passer d’un ordinateur à l’autre telle quelle.
Pour que cela tienne, la base porte un numéro de version. Chaque changement de sa structure s’écrit dans les deux versions, avec le même numéro. Et une version de Couvertures qui trouve une base plus récente qu’elle ne l’ouvre pas : elle le dit, plutôt que de risquer de l’abîmer.
Fait avec
Couvertures est écrite en Swift, le langage d’Apple, avec SwiftUI pour les écrans, une seule base de code pour l’iPhone, l’iPad et le Mac. Elle s’appuie sur les outils d’Apple pour le scanner, la lecture des codes-barres sur les photos, la dictée, la lecture des couvertures (Vision, Apple Intelligence) et iCloud Drive, et sur quelques composants libres : GRDB pour la base, Hummingbird pour le serveur. La liste complète, avec leurs licences, est dans la page À propos : Couvertures > À propos de Couvertures sur le Mac, en bas des Réglages sur l’iPhone.
Les fiches viennent de sources ouvertes ou publiques : la Bibliothèque nationale de France, Open Library, Google Books, MusicBrainz et la Cover Art Archive, Wikidata, et TMDB pour les films. Les affiches, les résumés et les genres des films viennent de TMDB. Couvertures utilise TMDB et les API de TMDB, mais n’est ni approuvée, ni certifiée, ni cautionnée par TMDB.