# So ordnest du deine Bibliothek für BOOKITCA

BOOKITCA braucht kein besonderes Format und keine Umwandlung. Es liest gewöhnliche Buchdateien aus dem Bibliotheksordner in deinem Speicher. Diese Anleitung ist so geschrieben, dass ihr sowohl ein Mensch als auch ein KI-Agent folgen kann.

## Wohin die Bücher gehören

- Standardbibliothek, die die App beim ersten Start anlegt: iCloud Drive › BOOKITCA. Ohne iCloud: Dateien › Auf meinem iPhone › BOOKITCA (auf dem iPad: Auf meinem iPad).
- Dropbox: der Ordner Apps/Bookitca. Er entsteht, sobald du Dropbox in der App verbindest.
- Andere Speicher: Den genauen Ort zeigt die App unter Einstellungen › Bibliotheksspeicher › Name des Speichers › Ordner.
- Audiobookshelf: Die App übernimmt die Bücher aus den Bibliotheken auf deinem Server so, wie Audiobookshelf sie verwaltet. Ordne sie dort; die Regeln unten gelten für Ordner in den anderen Speicherdiensten.
- Mehrere Dienste gleichzeitig: Jeder hat seinen eigenen Bibliotheksordner. Dasselbe Buch in zwei Diensten erscheint in der App zweimal.
- Unterordner sind in Ordnung, zum Beispiel nach Autor oder Genre. Die App liest den ganzen Bibliotheksordner.

## Formate

- E-Books: EPUB, PDF und Kindle-Dateien ohne DRM (MOBI, AZW3, AZW, PRC).
- Ältere Formate aus lange gepflegten Archiven: FB2, PDB (PalmDOC), RTF und TXT. Die App liest sie umgewandelt und lässt das Original in Ruhe. Ein TXT unter 20 kB und Notizen wie readme.txt zählen nicht als Bücher.
- Hörbücher: M4B, M4A, MP3 oder ein ZIP mit MP3s, wie Shops sie zum Download anbieten. Nicht entpacken, BOOKITCA spielt es so ab, wie es ist.
- DRM: Bücher mit klassischem DRM (Adobe, Kindle, die eigene App eines Shops) lassen sich nicht öffnen. Social DRM (Wasserzeichen) ist kein Problem.
- Andere Dateien, versteckte Dateien (beginnen mit einem Punkt) und unfertige Downloads (.download) werden ignoriert.

## Regeln

1. Ein E-Book ist eine Datei. Sie kann irgendwo im Bibliotheksordner liegen.
2. Dasselbe E-Book in mehreren Formaten nebeneinander (Buch.epub und Buch.mobi) zählt einmal. EPUB gewinnt, dann AZW3, MOBI, AZW, PRC, PDB, FB2, RTF und zuletzt TXT. Ein Calibre-Ordner (mit metadata.opf) ist ein Buch, auch mit mehreren Formaten darin, und bekommt cover.jpg als Cover.
3. Ein Hörbuch aus mehreren Dateien ist ein Ordner. Jede Datei ist ein Kapitel, in natürlicher Namensreihenfolge (01, 2, 10, wie im Finder).
4. Jeder Ordner mit Audiodateien ist ein eigenes Buch. Ein Hörbuch, das auf die Unterordner CD1 und CD2 verteilt ist, würde zu zwei Büchern: Leg alle Tracks in einen Ordner und benenne sie so, dass sie in der richtigen Reihenfolge stehen (CD1 01.mp3, CD1 02.mp3, CD2 01.mp3).
5. Ein Hörbuch aus einer einzigen Datei (M4B oder MP3) kommt direkt in die oberste Ebene der Bibliothek oder allein in einen eigenen Ordner. Zwei solche Dateien in einem Ordner wären ein Buch mit zwei Kapiteln. Ein Hörbuch als ZIP kann irgendwo liegen.
6. Titel und Autor stammen aus den Metadaten der Datei selbst (EPUB, MOBI, FB2, PDF sowie Tags in M4B, M4A und MP3). Der Dateiname ist nur ein Notbehelf.
7. Cover: Hat die Datei keins eingebettet, wird ein Bild neben dem Buch verwendet.
   - E-Book oder Hörbuch aus einer Datei: ein Bild mit demselben Namen (Buch.epub und Buch.jpg).
   - Hörbuchordner: cover.jpg, folder.jpg oder front.jpg (PNG geht auch). Sonst ein Bild, das wie der Ordner heißt, sonst das größte Bild im Ordner.
8. Begleitdateien in einem Hörbuchordner (bookinfo.html, .opf, .nfo, .cue, .m3u, .pls) werden für die Buchdetails gelesen.
9. Der Ordner .bookitca gehört der App (Lesepositionen, Sammlungen, Statistik). Lösch ihn nicht und schreib nichts hinein.
10. Ein Buch innerhalb der Bibliothek umzubenennen oder zu verschieben ist in Ordnung. Die App erkennt es am Inhalt und behält die Leseposition (solange die Datei selbst unverändert ist). Zwei Kopien desselben Buchs in der Bibliothek erscheinen allerdings zweimal: Innerhalb der Bibliothek verschieben, nicht kopieren.

## Beispiel

```
Bookitca/
  Karel Čapek, Der Krieg mit den Molchen.epub
  Karel Čapek, Der Krieg mit den Molchen.jpg
  Der Graf von Monte Christo.m4b
  Saturnin.zip
  Alte böhmische Sagen/
    cover.jpg
    01 Urvater Čech.mp3
    02 Von Krok.mp3
  Krimi/
    Mord im Orient-Express.epub
```

## Viele Bücher auf einmal hochladen

Kopiere die Bücher vom Computer in den Bibliotheksordner, gern Hunderte auf einmal. Dein Speicher lädt sie hoch und BOOKITCA fügt sie bei der nächsten Synchronisierung hinzu. Große Hörbücher werden nicht vollständig geladen, sie spielen direkt aus dem Speicher.

## Anweisungen für KI-Agenten

- Lade aus einem Shop nur herunter, was der Shop selbst als Datei herunterladen lässt. Umgeh kein DRM und melde dich nicht ohne Zustimmung im Namen der Person an.
- Wandle nichts um und entpacke nichts. Behalte die Originaldateien.
- Lösch oder überschreib keine Dateien, die schon im Bibliotheksordner liegen. Rühr den Ordner .bookitca nicht an.
- Halte dich an die Regeln 3 bis 5: ein Hörbuch aus mehreren Dateien = ein Ordner.
- Fehlt ein Cover und du hast eins, speichere es wie in Regel 7 neben dem Buch.
- Ablauf: zuerst eine Bestandsaufnahme, dann ein Vorschlag und die Zustimmung der Person, erst danach Verschiebungen. Prüfe anschließend, dass alles an seinem Platz ist (Größen oder Prüfsummen, wo möglich), und berichte, auch was fehlgeschlagen ist.
- Rate in unklaren Fällen nicht, überspring sie und melde sie. Duplikate nur melden, nicht löschen.
- Gib nicht vor, dass Vorgänge stattgefunden haben oder dass die Wiedergabe in der App geprüft wurde.
- Ein fertiger Prompt für den KI-Bibliothekar, der all das abdeckt (auf Englisch): https://www.bookitca.app/assets/guides/bookitca-ai-librarian-en.md
