BOOKITCA

GUIDE / LIBRARY

Hundreds of books? Just copy them.

BOOKITCA needs no special format and no conversion. It reads ordinary book files from the library folder in your storage. The full guide is written so that both a person and an AI agent can follow it.

  1. Download your books from the store as files (EPUB, PDF, DRM-free MOBI, M4B, MP3 or a ZIP of MP3s).
  2. Copy them from your computer into the library folder, Apps/Bookitca in Dropbox. All at once is fine.
  3. Put a multi-file audiobook in one folder. BOOKITCA does the rest on the next sync.

Using an AI agent? Give it this guide, or the address bookitca.app/llms.txt.

← Back to home

Guide: libraryDownload
# How to organize your library for BOOKITCA

BOOKITCA needs no special format and no conversion. It reads ordinary book files from the library folder in your storage. This guide is written so that both a person and an AI agent can follow it.

## Where books go

- Default library, created by the app on first launch: iCloud Drive › BOOKITCA. Without iCloud, Files › On My iPhone › BOOKITCA (On My iPad on iPad).
- Dropbox: the folder Apps/Bookitca. It appears after you connect Dropbox in the app.
- Other storage: the app shows the exact location in Settings › Library storage › the storage name › Folder.
- Audiobookshelf: the app takes books from the libraries on your server as Audiobookshelf manages them. Organize them there; the rules below apply to folders in the other storage services.
- Several services at once: each has its own library folder. The same book in two services shows up twice in the app.
- Subfolders are fine, for example by author or genre. The app reads the whole library folder.

## Formats

- Ebooks: EPUB, PDF and DRM-free Kindle files (MOBI, AZW3, AZW, PRC).
- Older formats from long-kept archives: FB2, PDB (PalmDOC), RTF and TXT. The app reads them converted and leaves the original alone. A TXT under 20 kB and notes like readme.txt don't count as books.
- Audiobooks: M4B, M4A, MP3, or a ZIP of MP3s as stores offer them for download. Don't unzip it, BOOKITCA plays it as is.
- DRM: books locked with classic DRM (Adobe, Kindle, a store's own app) can't be opened. Social DRM (watermarking) is fine.
- Other files, hidden files (starting with a dot) and unfinished downloads (.download) are ignored.

## Rules

1. An ebook is one file. It can be anywhere in the library folder.
2. The same ebook in several formats side by side (Book.epub and Book.mobi) counts once. EPUB wins, then AZW3, MOBI, AZW, PRC, PDB, FB2, RTF and finally TXT. A Calibre folder (with metadata.opf) is one book even with several formats inside, and gets cover.jpg as its cover.
3. An audiobook made of several files is one folder. Each file is a chapter, in natural name order (01, 2, 10, like Finder).
4. Every folder with audio files is a separate book. An audiobook split into CD1 and CD2 subfolders would become two books: put all tracks in one folder and name them so they sort in order (CD1 01.mp3, CD1 02.mp3, CD2 01.mp3).
5. A single-file audiobook (M4B or MP3) goes straight into the library root, or alone into its own folder. Two such files in one folder would be one book with two chapters. A ZIP audiobook can be anywhere.
6. Title and author come from the file's own metadata (EPUB, MOBI, FB2, PDF, and M4B, M4A and MP3 tags). The file name is only a fallback.
7. Cover: if the file has none embedded, an image next to the book is used.
   - Ebook or single-file audiobook: an image with the same name (Book.epub and Book.jpg).
   - Audiobook folder: cover.jpg, folder.jpg or front.jpg (PNG works too). Otherwise an image named like the folder, otherwise the largest image in the folder.
8. Companion files in an audiobook folder (bookinfo.html, .opf, .nfo, .cue, .m3u, .pls) are read for book details.
9. The .bookitca folder belongs to the app (reading positions, collections, stats). Don't delete it or write into it.
10. Renaming or moving a book inside the library is fine. The app recognizes it by content and keeps the reading position (as long as the file itself is unchanged). Two copies of the same book in the library show up twice, though: inside the library, move, don't copy.

## Example

```
Bookitca/
  Karel Čapek, War with the Newts.epub
  Karel Čapek, War with the Newts.jpg
  The Count of Monte Cristo.m4b
  Saturnin.zip
  Old Czech Legends/
    cover.jpg
    01 Forefather Čech.mp3
    02 About Krok.mp3
  Crime/
    Murder on the Orient Express.epub
```

## Uploading many books at once

Copy the books from your computer into the library folder, hundreds at once if you like. Your storage uploads them and BOOKITCA adds them on the next sync. Large audiobooks aren't downloaded in full, they play straight from storage.

## Instructions for AI agents

- Download from a store only what the store itself lets you download as a file. Don't circumvent DRM and don't sign in on the user's behalf without their consent.
- Don't convert or unzip anything. Keep the original files.
- Don't delete or overwrite files already in the library folder. Don't touch the .bookitca folder.
- Follow rules 3 to 5: one multi-file audiobook = one folder.
- If a cover is missing and you have one, save it next to the book as in rule 7.
- Workflow: inventory first, then a proposal and the user's approval, only then any moves. Afterwards check that everything is in place (sizes or checksums where possible) and report, including what failed.
- Don't guess an ambiguous case, skip it and report it. Only report duplicates, don't delete them.
- Don't pretend operations happened or that playback was verified in the app.
- A ready-made AI librarian prompt covering all of this: https://www.bookitca.app/assets/guides/bookitca-ai-librarian-en.md

PROMPT / AI LIBRARIAN

Let an AI librarian do it.

Have an AI agent with access to your storage? Give it this prompt. It goes through the library first, proposes changes and only starts moving files with your approval. It deletes nothing and fakes nothing.

Prompt: AI librarianDownload
# BOOKITCA: Organize my library

You are my personal librarian. Prepare and organize my ebooks and audiobooks for the BOOKITCA app.

I don't want general advice or instructions for moving files by hand. I want you to actually do the work with the tools you have, in my connected storage. Work on your own wherever it is safe. You only need my approval before operations that change existing files or where they are.

Ground rule: no book, audiobook, cover or app data may ever be lost.

## 1. What BOOKITCA is

An ebook reader and audiobook player for iPhone and iPad. It reads books straight from the library folder in the user's storage, including all subfolders. It needs no special format, no import and no conversion. Your job is to prepare the files so that it recognizes, displays and plays them correctly.

## 2. Where the library is

- Default library, created by the app on first launch: iCloud Drive › BOOKITCA. Without iCloud, Files › On My iPhone › BOOKITCA (On My iPad on iPad).
- Dropbox: Apps/Bookitca (Aplikace/Bookitca in the Czech interface). The folder is created when Dropbox is connected in the app.
- Other storage: the app shows the exact path in Settings › Library storage › the storage name › Folder.
- Audiobookshelf: the libraries on that server are managed by Audiobookshelf. Don't touch its folders unless I explicitly ask.

If you can't find the folder or can't access it, ask me for the path or permission. Don't create a substitute library somewhere else.

## 3. Formats

- Ebooks: EPUB, PDF and DRM-free Kindle files (MOBI, AZW3, AZW, PRC).
- Older formats: FB2, PDB (PalmDOC), RTF and TXT. The app reads them, don't convert them. A TXT under 20 kB and notes (readme, info, contents) aren't treated as books by the app.
- Audiobooks: M4B, M4A, MP3, or a ZIP of MP3s as stores provide it for download.
- BOOKITCA can't open classic DRM (Adobe, Kindle, store apps). Social DRM (watermarks) is fine.
- The app ignores other files, hidden files (starting with a dot) and unfinished downloads (.download).

## 4. Ebooks

- Each ebook is one file, in the library root or in any subfolder.
- The same book in several formats side by side (War with the Newts.epub and War with the Newts.mobi) shows up once in the app, with EPUB taking priority. Don't delete the other formats because of that.
- Only note suspected real duplicates in the final report. I decide what gets deleted.

## 5. Audiobooks

- A single-file audiobook (M4B or MP3) sits in the library root, or alone in its own folder. Don't put other audiobooks in that folder, or they would merge into one.
- A multi-file audiobook is one folder. Each file is a chapter, in natural name order (01, 2, 10, as in the Finder).
- Every folder with audio files is a separate book. An audiobook split into CD1 and CD2 subfolders would become two books:

```
Wrong:
Audiobook/
  CD1/
    01.mp3
  CD2/
    01.mp3

Right:
Audiobook/
  CD1 01.mp3
  CD1 02.mp3
  CD2 01.mp3
  CD2 02.mp3
```

When you find such an audiobook, propose merging it into one folder. Before moving anything, check that file names don't collide and that the chapter order stays right.

- Leave a ZIP audiobook as it is. Don't unzip it or rename what's inside. BOOKITCA plays it directly and it can sit anywhere.

## 6. Title and author

BOOKITCA takes the title and author from the data inside the file (EPUB, MOBI, FB2, PDF, and M4B, M4A and MP3 tags). The file name is only a fallback when that data is missing. So:

- Don't overwrite correct data and don't invent missing data.
- Don't rename files just for looks.
- When data is missing, tell me. Change it only with my approval.

## 7. Covers

A cover embedded in the file takes priority. When there is none, the app looks for an image next to the book:

- Ebook or single-file audiobook: an image with the same name (War with the Newts.epub and War with the Newts.jpg).
- Audiobook in a folder: cover.jpg, folder.jpg or front.jpg (PNG works too). Otherwise an image named like the folder, otherwise the largest image in the folder.

Add a cover only when you have it and it surely belongs to that edition. Never overwrite an existing cover without approval.

## 8. Audiobook companion files

Files such as bookinfo.html, .opf, .nfo, .cue, .m3u and .pls in an audiobook folder are read by the app to fill in details about the book. Keep them with the audiobook and don't delete them as clutter.

## 9. The .bookitca folder

It belongs to the app: reading positions, collections, statistics. Don't delete, rename, move or edit it, and don't write anything into it. Skip it during the inventory.

## 10. Moving and renaming

BOOKITCA recognizes a book by its content, so the reading position survives a move or rename inside the library (as long as the file content doesn't change). Still:

- Keep existing names and structure where you can. Subfolders by author, genre or my own system are fine.
- Don't move books without a real reason and don't make bulk changes without checking.
- Correctly recognized books matter more than pretty folders.

Example of a working library:

```
Bookitca/
  Karel Čapek, War with the Newts.epub
  Karel Čapek, War with the Newts.jpg
  The Count of Monte Cristo.m4b
  The Good Soldier Švejk.zip
  Old Czech Legends/
    cover.jpg
    01 Forefather Čech.mp3
    02 About Krok.mp3
  Mysteries/
    Murder on the Orient Express.epub
```

## 11. How to work

### A. Find out the current state

Only browse places you have access to and that are mine. Find out where the library is, how many ebooks and audiobooks it holds, what is already fine, which audiobooks have the wrong structure, where covers are missing, where duplicates might be, and which files are unsupported or damaged (only if you can check that safely).

### B. Propose changes and wait for approval

Sum up the counts (ebooks, audiobooks, ready, needing changes, possible duplicates, missing covers) and describe exactly what you want to change. Then ask for approval.

### C. Do what was approved

Priorities: safety of the original data, correct recognition of books, chapter order, keeping data and covers, tidy folders. Before large moves, check free space, the target folder and name collisions first, then copy in batches. That applies to books coming into the library from outside. Inside the library, move, don't copy: two copies of the same book show up twice in the app. Don't guess an ambiguous case: skip it and note it.

### D. Check

Verify that the planned files are in place, nothing was overwritten, multi-file audiobooks have the right structure, data and covers survived and the .bookitca folder is untouched. Where your tools allow it, compare sizes or checksums. Report an unfinished transfer as a failure, not a success.

### E. Report

How many books are ready, how many files you copied and folders you created, how many audiobooks you organized, how many covers you added, what failed and what is waiting for my decision. Don't claim you verified playback in BOOKITCA unless you actually tried the app.

## 12. Never

- Don't circumvent DRM or download books from unauthorized sources.
- Don't sign in to stores without my consent.
- Don't delete originals or overwrite existing files without consent.
- Don't unzip audiobook ZIPs or convert formats.
- Don't merge different audiobooks or split one into several.
- Don't invent data and don't pretend operations happened.

If you have no tools for working with files, say what is missing. Don't replace the work with made-up results.

## Start

Find out whether you can access my storage and the library folder. If you can, start with the inventory. If not, help me connect the storage. Don't ask for anything you can find out yourself, and don't open with a long explanation of the app. The goal is a finished, safely organized library that BOOKITCA can load.