# Como organizar sua biblioteca para o BOOKITCA

O BOOKITCA não precisa de nenhum formato especial nem de conversão. Ele lê arquivos de livros comuns da pasta da biblioteca no seu armazenamento. Este guia foi escrito para que tanto uma pessoa quanto um agente de IA possam segui-lo.

## Onde ficam os livros

- Biblioteca padrão, criada pelo app na primeira abertura: iCloud Drive › BOOKITCA. Sem iCloud: Arquivos › No Meu iPhone › BOOKITCA (No Meu iPad, no iPad).
- Dropbox: a pasta Apps/Bookitca. Ela aparece depois que você conecta o Dropbox no app.
- Outros armazenamentos: o app mostra o local exato em Ajustes › Armazenamento da biblioteca › nome do armazenamento › Pasta.
- Audiobookshelf: o app pega os livros das bibliotecas do seu servidor do jeito que o Audiobookshelf os gerencia. Organize-os lá; as regras abaixo valem para as pastas dos outros serviços de armazenamento.
- Vários serviços ao mesmo tempo: cada um tem sua própria pasta de biblioteca. O mesmo livro em dois serviços aparece duas vezes no app.
- Subpastas não são problema, por exemplo por autor ou por gênero. O app lê a pasta inteira da biblioteca.

## Formatos

- E-books: EPUB, PDF e arquivos de Kindle sem DRM (MOBI, AZW3, AZW, PRC).
- Formatos mais antigos de acervos guardados há muito tempo: FB2, PDB (PalmDOC), RTF e TXT. O app os lê convertidos e não mexe no original. Um TXT com menos de 20 kB e notas como readme.txt não contam como livros.
- Audiolivros: M4B, M4A, MP3 ou um ZIP de MP3, do jeito que as lojas oferecem para download. Não descompacte, o BOOKITCA toca o arquivo como ele é.
- DRM: livros travados com DRM clássico (Adobe, Kindle, o app próprio de uma loja) não podem ser abertos. DRM social (marca d’água) não é problema.
- Outros arquivos, arquivos ocultos (que começam com ponto) e downloads incompletos (.download) são ignorados.

## Regras

1. Um e-book é um arquivo. Ele pode estar em qualquer lugar da pasta da biblioteca.
2. O mesmo e-book em vários formatos lado a lado (Livro.epub e Livro.mobi) conta uma vez. O EPUB vence, depois AZW3, MOBI, AZW, PRC, PDB, FB2, RTF e, por último, TXT. Uma pasta do Calibre (com metadata.opf) é um só livro, mesmo com vários formatos dentro, e usa cover.jpg como capa.
3. Um audiolivro de vários arquivos é uma pasta. Cada arquivo é um capítulo, na ordem natural dos nomes (01, 2, 10, como no Finder).
4. Cada pasta com arquivos de áudio é um livro separado. Um audiolivro dividido nas subpastas CD1 e CD2 viraria dois livros: coloque todas as faixas em uma pasta e dê nomes que fiquem em ordem (CD1 01.mp3, CD1 02.mp3, CD2 01.mp3).
5. Um audiolivro de um só arquivo (M4B ou MP3) vai direto na raiz da biblioteca ou sozinho em uma pasta própria. Dois arquivos assim na mesma pasta seriam um livro com dois capítulos. Um audiolivro em ZIP pode ficar em qualquer lugar.
6. Título e autor vêm dos metadados do próprio arquivo (EPUB, MOBI, FB2, PDF e tags de M4B, M4A e MP3). O nome do arquivo é só um plano B.
7. Capa: se o arquivo não tiver uma embutida, é usada uma imagem ao lado do livro.
   - E-book ou audiolivro de um só arquivo: uma imagem com o mesmo nome (Livro.epub e Livro.jpg).
   - Pasta de audiolivro: cover.jpg, folder.jpg ou front.jpg (PNG também funciona). Senão, uma imagem com o nome da pasta; senão, a maior imagem da pasta.
8. Arquivos complementares em uma pasta de audiolivro (bookinfo.html, .opf, .nfo, .cue, .m3u, .pls) são lidos para obter os dados do livro.
9. A pasta .bookitca pertence ao app (posições de leitura, coleções, estatísticas). Não a apague nem grave nada nela.
10. Renomear ou mover um livro dentro da biblioteca não tem problema. O app o reconhece pelo conteúdo e mantém a posição de leitura (desde que o arquivo em si não mude). Duas cópias do mesmo livro na biblioteca, porém, aparecem duas vezes: dentro da biblioteca, mova, não copie.

## Exemplo

```
Bookitca/
  Karel Čapek, A Guerra das Salamandras.epub
  Karel Čapek, A Guerra das Salamandras.jpg
  O Conde de Monte Cristo.m4b
  Saturnin.zip
  Antigas lendas tchecas/
    cover.jpg
    01 O patriarca Čech.mp3
    02 Krok.mp3
  Policiais/
    Assassinato no Expresso do Oriente.epub
```

## Enviar muitos livros de uma vez

Copie os livros do computador para a pasta da biblioteca, centenas de uma vez se quiser. Seu armazenamento os envia e o BOOKITCA os adiciona na próxima sincronização. Audiolivros grandes não são baixados por inteiro, eles tocam direto do armazenamento.

## Instruções para agentes de IA

- Baixe de uma loja apenas o que a própria loja permite baixar como arquivo. Não contorne DRM e não entre na conta do usuário sem o consentimento dele.
- Não converta nem descompacte nada. Mantenha os arquivos originais.
- Não apague nem sobrescreva arquivos que já estão na pasta da biblioteca. Não mexa na pasta .bookitca.
- Siga as regras 3 a 5: um audiolivro de vários arquivos = uma pasta.
- Se faltar uma capa e você tiver uma, salve-a ao lado do livro como na regra 7.
- Fluxo de trabalho: primeiro um inventário, depois uma proposta e a aprovação do usuário, e só então qualquer movimentação. No fim, confira se tudo está no lugar (tamanhos ou checksums quando possível) e faça um relatório, inclusive do que deu errado.
- Não chute em casos ambíguos: pule e relate. Duplicatas, apenas relate, não apague.
- Não finja que operações aconteceram nem que a reprodução foi verificada no app.
- Um prompt pronto de bibliotecário de IA que cobre tudo isso (em inglês): https://www.bookitca.app/assets/guides/bookitca-ai-librarian-en.md
