GUÍA / BIBLIOTECA
¿Cientos de libros? Solo cópialos.
BOOKITCA no necesita ningún formato especial ni conversión. Lee archivos de libros normales de la carpeta de la biblioteca de tu almacenamiento. La guía completa está escrita para que la pueda seguir tanto una persona como un agente de IA.
- Descarga tus libros de la tienda como archivos (EPUB, PDF, MOBI sin DRM, M4B, MP3 o un ZIP de MP3).
- Cópialos desde el ordenador a la carpeta de la biblioteca, Apps/Bookitca en Dropbox. Todos a la vez también vale.
- Pon un audiolibro de varios archivos en una sola carpeta. BOOKITCA hace el resto en la siguiente sincronización.
¿Usas un agente de IA? Dale esta guía o la dirección bookitca.app/llms.txt.
# Cómo organizar tu biblioteca para BOOKITCA
BOOKITCA no necesita ningún formato especial ni conversión. Lee archivos de libros normales de la carpeta de la biblioteca de tu almacenamiento. Esta guía está escrita para que la pueda seguir tanto una persona como un agente de IA.
## Dónde van los libros
- Biblioteca predeterminada, que la app crea al abrirla por primera vez: iCloud Drive › BOOKITCA. Sin iCloud: Archivos › En mi iPhone › BOOKITCA (En mi iPad en el iPad).
- Dropbox: la carpeta Apps/Bookitca. Aparece al conectar Dropbox en la app.
- Otros almacenamientos: la app muestra la ubicación exacta en Ajustes › Almacenamiento de la biblioteca › nombre del almacenamiento › Carpeta.
- Audiobookshelf: la app toma los libros de las bibliotecas de tu servidor tal como los gestiona Audiobookshelf. Organízalos allí; las reglas de abajo se aplican a las carpetas de los demás servicios de almacenamiento.
- Varios servicios a la vez: cada uno tiene su propia carpeta de biblioteca. El mismo libro en dos servicios aparece dos veces en la app.
- Las subcarpetas están bien, por ejemplo por autor o por género. La app lee toda la carpeta de la biblioteca.
## Formatos
- Ebooks: EPUB, PDF y archivos de Kindle sin DRM (MOBI, AZW3, AZW, PRC).
- Formatos antiguos de archivos guardados durante años: FB2, PDB (PalmDOC), RTF y TXT. La app los lee convertidos y deja el original intacto. Un TXT de menos de 20 kB y notas como readme.txt no cuentan como libros.
- Audiolibros: M4B, M4A, MP3 o un ZIP de MP3 tal como lo ofrecen las tiendas para descargar. No lo descomprimas, BOOKITCA lo reproduce tal cual.
- DRM: los libros bloqueados con DRM clásico (Adobe, Kindle, la app propia de una tienda) no se pueden abrir. El DRM social (marca de agua) no da problemas.
- Los demás archivos, los archivos ocultos (empiezan por un punto) y las descargas sin terminar (.download) se ignoran.
## Reglas
1. Un ebook es un archivo. Puede estar en cualquier lugar de la carpeta de la biblioteca.
2. El mismo ebook en varios formatos, uno junto a otro (Libro.epub y Libro.mobi), cuenta una vez. Gana EPUB, luego AZW3, MOBI, AZW, PRC, PDB, FB2, RTF y por último TXT. Una carpeta de Calibre (con metadata.opf) es un solo libro aunque tenga varios formatos dentro, y usa cover.jpg como portada.
3. Un audiolibro de varios archivos es una carpeta. Cada archivo es un capítulo, en el orden natural de los nombres (01, 2, 10, como en el Finder).
4. Cada carpeta con archivos de audio es un libro distinto. Un audiolibro dividido en subcarpetas CD1 y CD2 se convertiría en dos libros: pon todas las pistas en una carpeta y nómbralas para que queden en orden (CD1 01.mp3, CD1 02.mp3, CD2 01.mp3).
5. Un audiolibro de un solo archivo (M4B o MP3) va directamente en la raíz de la biblioteca o solo en su propia carpeta. Dos archivos así en una misma carpeta serían un libro con dos capítulos. Un audiolibro en ZIP puede estar en cualquier sitio.
6. El título y el autor salen de los metadatos del propio archivo (EPUB, MOBI, FB2, PDF y las etiquetas de M4B, M4A y MP3). El nombre del archivo es solo un recurso de reserva.
7. Portada: si el archivo no tiene una incrustada, se usa una imagen junto al libro.
- Ebook o audiolibro de un solo archivo: una imagen con el mismo nombre (Libro.epub y Libro.jpg).
- Carpeta de audiolibro: cover.jpg, folder.jpg o front.jpg (también sirve PNG). Si no, una imagen con el nombre de la carpeta y, si no, la imagen más grande de la carpeta.
8. Los archivos complementarios de una carpeta de audiolibro (bookinfo.html, .opf, .nfo, .cue, .m3u, .pls) se leen para obtener los datos del libro.
9. La carpeta .bookitca es de la app (posiciones de lectura, colecciones, estadísticas). No la borres ni escribas en ella.
10. Renombrar o mover un libro dentro de la biblioteca no da problemas. La app lo reconoce por su contenido y conserva la posición de lectura (mientras el archivo en sí no cambie). Eso sí, dos copias del mismo libro en la biblioteca aparecen dos veces: dentro de la biblioteca, mueve, no copies.
## Ejemplo
```
Bookitca/
Karel Čapek, La guerra de las salamandras.epub
Karel Čapek, La guerra de las salamandras.jpg
El conde de Montecristo.m4b
Saturnin.zip
Antiguas leyendas checas/
cover.jpg
01 El patriarca Čech.mp3
02 Krok.mp3
Policiaca/
Asesinato en el Orient Express.epub
```
## Subir muchos libros a la vez
Copia los libros desde el ordenador a la carpeta de la biblioteca, cientos a la vez si quieres. Tu almacenamiento los sube y BOOKITCA los añade en la siguiente sincronización. Los audiolibros grandes no se descargan enteros, se reproducen directamente desde el almacenamiento.
## Instrucciones para agentes de IA
- Descarga de una tienda solo lo que la propia tienda deja descargar como archivo. No eludas el DRM ni inicies sesión en nombre del usuario sin su consentimiento.
- No conviertas ni descomprimas nada. Conserva los archivos originales.
- No borres ni sobrescribas archivos que ya estén en la carpeta de la biblioteca. No toques la carpeta .bookitca.
- Sigue las reglas 3 a 5: un audiolibro de varios archivos = una carpeta.
- Si falta una portada y tienes una, guárdala junto al libro como indica la regla 7.
- Flujo de trabajo: primero un inventario, luego una propuesta y la aprobación del usuario, y solo después cualquier movimiento. Al terminar, comprueba que todo está en su sitio (tamaños o sumas de verificación cuando se pueda) e informa, también de lo que haya fallado.
- No adivines un caso ambiguo: sáltatelo e infórmalo. Los duplicados, solo infórmalos, no los borres.
- No finjas que se hicieron operaciones ni que se comprobó la reproducción en la app.
- Un prompt de bibliotecario IA listo para usar que cubre todo esto (en inglés): https://www.bookitca.app/assets/guides/bookitca-ai-librarian-en.mdPROMPT / BIBLIOTECARIO IA
Deja que lo haga un bibliotecario IA.
¿Tienes un agente de IA con acceso a tu almacenamiento? Dale este prompt. Primero recorre la biblioteca, propone cambios y solo empieza a mover archivos con tu aprobación. No borra nada y no finge nada.
El prompt está en inglés. Los agentes de IA lo siguen igual de bien, y puedes pedirle al tuyo que te responda en español.