# Organiser votre bibliothèque pour BOOKITCA

BOOKITCA n’exige aucun format particulier ni aucune conversion. L’app lit des fichiers de livres ordinaires dans le dossier de la bibliothèque de votre stockage. Ce guide est rédigé pour qu’une personne comme un agent IA puisse le suivre.

## Où placer les livres

- Bibliothèque par défaut, créée par l’app au premier lancement : iCloud Drive › BOOKITCA. Sans iCloud : Fichiers › Sur mon iPhone › BOOKITCA (Sur mon iPad sur iPad).
- Dropbox : le dossier Apps/Bookitca. Il apparaît une fois Dropbox connecté dans l’app.
- Autres stockages : l’app indique l’emplacement exact dans Réglages › Stockage de la bibliothèque › nom du stockage › Dossier.
- Audiobookshelf : l’app reprend les livres des bibliothèques de votre serveur tels qu’Audiobookshelf les gère. Organisez-les là-bas ; les règles ci-dessous concernent les dossiers des autres services de stockage.
- Plusieurs services à la fois : chacun a son propre dossier de bibliothèque. Le même livre dans deux services apparaît deux fois dans l’app.
- Les sous-dossiers sont acceptés, par exemple par auteur ou par genre. L’app lit tout le dossier de la bibliothèque.

## Formats

- Ebooks : EPUB, PDF et fichiers Kindle sans DRM (MOBI, AZW3, AZW, PRC).
- Formats plus anciens issus d’archives conservées de longue date : FB2, PDB (PalmDOC), RTF et TXT. L’app les lit après conversion et laisse l’original intact. Un TXT de moins de 20 ko et les notes comme readme.txt ne comptent pas comme des livres.
- Livres audio : M4B, M4A, MP3, ou un ZIP de MP3 tel que les librairies le proposent au téléchargement. Ne le décompressez pas, BOOKITCA le lit tel quel.
- DRM : les livres verrouillés par un DRM classique (Adobe, Kindle, l’app d’une librairie) ne peuvent pas être ouverts. Le DRM social (tatouage) ne pose aucun problème.
- Les autres fichiers, les fichiers cachés (qui commencent par un point) et les téléchargements inachevés (.download) sont ignorés.

## Règles

1. Un ebook est un fichier. Il peut se trouver n’importe où dans le dossier de la bibliothèque.
2. Le même ebook en plusieurs formats côte à côte (Livre.epub et Livre.mobi) compte une seule fois. L’EPUB l’emporte, puis AZW3, MOBI, AZW, PRC, PDB, FB2, RTF et enfin TXT. Un dossier Calibre (avec metadata.opf) est un seul livre, même avec plusieurs formats à l’intérieur, et prend cover.jpg comme couverture.
3. Un livre audio en plusieurs fichiers est un dossier. Chaque fichier est un chapitre, dans l’ordre naturel des noms (01, 2, 10, comme dans le Finder).
4. Chaque dossier contenant des fichiers audio est un livre distinct. Un livre audio réparti dans des sous-dossiers CD1 et CD2 deviendrait deux livres : placez toutes les pistes dans un seul dossier et nommez-les pour qu’elles se suivent (CD1 01.mp3, CD1 02.mp3, CD2 01.mp3).
5. Un livre audio en un seul fichier (M4B ou MP3) va directement à la racine de la bibliothèque, ou seul dans son propre dossier. Deux fichiers de ce type dans un même dossier formeraient un seul livre de deux chapitres. Un livre audio en ZIP peut se trouver n’importe où.
6. Le titre et l’auteur viennent des métadonnées du fichier lui-même (EPUB, MOBI, FB2, PDF, et balises M4B, M4A et MP3). Le nom du fichier n’est qu’une solution de secours.
7. Couverture : si le fichier n’en contient pas, une image placée à côté du livre est utilisée.
   - Ebook ou livre audio en un seul fichier : une image portant le même nom (Livre.epub et Livre.jpg).
   - Dossier de livre audio : cover.jpg, folder.jpg ou front.jpg (le PNG fonctionne aussi). Sinon une image nommée comme le dossier, sinon la plus grande image du dossier.
8. Les fichiers d’accompagnement d’un dossier de livre audio (bookinfo.html, .opf, .nfo, .cue, .m3u, .pls) sont lus pour les informations sur le livre.
9. Le dossier .bookitca appartient à l’app (positions de lecture, collections, statistiques). Ne le supprimez pas et n’y écrivez rien.
10. Renommer ou déplacer un livre à l’intérieur de la bibliothèque ne pose aucun problème. L’app le reconnaît à son contenu et conserve la position de lecture (tant que le fichier lui-même n’est pas modifié). Deux copies du même livre dans la bibliothèque apparaissent en revanche deux fois : à l’intérieur de la bibliothèque, déplacez, ne copiez pas.

## Exemple

```
Bookitca/
  Karel Čapek, La Guerre des salamandres.epub
  Karel Čapek, La Guerre des salamandres.jpg
  Le Comte de Monte-Cristo.m4b
  Saturnin.zip
  Vieilles légendes tchèques/
    cover.jpg
    01 L’ancêtre Čech.mp3
    02 Krok.mp3
  Policiers/
    Le Crime de l’Orient-Express.epub
```

## Importer beaucoup de livres à la fois

Copiez les livres depuis votre ordinateur dans le dossier de la bibliothèque, des centaines d’un coup si vous voulez. Votre stockage les envoie et BOOKITCA les ajoute à la prochaine synchronisation. Les gros livres audio ne sont pas téléchargés en entier, ils se lisent directement depuis le stockage.

## Instructions pour les agents IA

- Ne téléchargez depuis une librairie que ce qu’elle permet elle-même de télécharger sous forme de fichier. Ne contournez pas les DRM et ne vous connectez pas au nom de l’utilisateur sans son accord.
- Ne convertissez et ne décompressez rien. Conservez les fichiers d’origine.
- Ne supprimez ni n’écrasez les fichiers déjà présents dans le dossier de la bibliothèque. Ne touchez pas au dossier .bookitca.
- Suivez les règles 3 à 5 : un livre audio en plusieurs fichiers = un dossier.
- S’il manque une couverture et que vous en avez une, enregistrez-la à côté du livre comme l’indique la règle 7.
- Méthode : d’abord un inventaire, puis une proposition et l’accord de l’utilisateur, ensuite seulement les déplacements. Vérifiez ensuite que tout est en place (tailles ou sommes de contrôle si possible) et faites un compte rendu, y compris de ce qui a échoué.
- Ne devinez pas en cas d’ambiguïté, laissez le cas de côté et signalez-le. Signalez les doublons sans les supprimer.
- Ne prétendez pas que des opérations ont eu lieu ni que la lecture a été vérifiée dans l’app.
- Un prompt de bibliothécaire IA prêt à l’emploi qui couvre tout cela (en anglais) : https://www.bookitca.app/assets/guides/bookitca-ai-librarian-en.md
