GUIDA / LIBRERIA
Centinaia di libri? Basta copiarli.
BOOKITCA non richiede nessun formato speciale e nessuna conversione. Legge normali file di libri dalla cartella della libreria nel tuo spazio di archiviazione. La guida completa è scritta in modo che possa seguirla sia una persona sia un agente IA.
- Scarica i tuoi libri dal negozio come file (EPUB, PDF, MOBI senza DRM, M4B, MP3 o uno ZIP di MP3).
- Copiali dal computer nella cartella della libreria, in Dropbox Apps/Bookitca. Anche tutti insieme.
- Metti un audiolibro composto da più file in una sola cartella. Al resto pensa BOOKITCA alla sincronizzazione successiva.
Usi un agente IA? Dagli questa guida, oppure l’indirizzo bookitca.app/llms.txt.
# Come organizzare la tua libreria per BOOKITCA
BOOKITCA non richiede nessun formato speciale e nessuna conversione. Legge normali file di libri dalla cartella della libreria nel tuo spazio di archiviazione. Questa guida è scritta in modo che possa seguirla sia una persona sia un agente IA.
## Dove vanno i libri
- Libreria predefinita, creata dall’app al primo avvio: iCloud Drive › BOOKITCA. Senza iCloud: File › Su iPhone › BOOKITCA (Su iPad su iPad).
- Dropbox: la cartella Apps/Bookitca. Compare dopo aver collegato Dropbox nell’app.
- Altri servizi: l’app mostra la posizione esatta in Impostazioni › Archiviazione della libreria › nome del servizio › Cartella.
- Audiobookshelf: l’app prende i libri dalle librerie del tuo server così come li gestisce Audiobookshelf. Organizzali lì; le regole qui sotto valgono per le cartelle degli altri servizi di archiviazione.
- Più servizi insieme: ognuno ha la propria cartella della libreria. Lo stesso libro in due servizi compare due volte nell’app.
- Le sottocartelle vanno bene, per esempio per autore o per genere. L’app legge l’intera cartella della libreria.
## Formati
- Ebook: EPUB, PDF e file Kindle senza DRM (MOBI, AZW3, AZW, PRC).
- Formati più vecchi da archivi conservati a lungo: FB2, PDB (PalmDOC), RTF e TXT. L’app li legge convertiti e lascia intatto l’originale. Un TXT sotto i 20 kB e note come readme.txt non contano come libri.
- Audiolibri: M4B, M4A, MP3 o uno ZIP di MP3 come quelli che i negozi offrono da scaricare. Non decomprimerlo, BOOKITCA lo riproduce così com’è.
- DRM: i libri bloccati con DRM classico (Adobe, Kindle, l’app di un negozio) non si possono aprire. Il social DRM (filigrana) va bene.
- Gli altri file, i file nascosti (che iniziano con un punto) e i download incompleti (.download) vengono ignorati.
## Regole
1. Un ebook è un file. Può stare ovunque nella cartella della libreria.
2. Lo stesso ebook in più formati uno accanto all’altro (Libro.epub e Libro.mobi) conta una volta. Vince EPUB, poi AZW3, MOBI, AZW, PRC, PDB, FB2, RTF e infine TXT. Una cartella di Calibre (con metadata.opf) è un solo libro anche con più formati dentro, e prende cover.jpg come copertina.
3. Un audiolibro composto da più file è una cartella. Ogni file è un capitolo, nell’ordine naturale dei nomi (01, 2, 10, come nel Finder).
4. Ogni cartella con file audio è un libro a sé. Un audiolibro diviso nelle sottocartelle CD1 e CD2 diventerebbe due libri: metti tutte le tracce in una cartella e dai loro nomi che le mettano in ordine (CD1 01.mp3, CD1 02.mp3, CD2 01.mp3).
5. Un audiolibro in un solo file (M4B o MP3) va direttamente nella radice della libreria, oppure da solo in una propria cartella. Due file del genere nella stessa cartella sarebbero un solo libro con due capitoli. Un audiolibro in ZIP può stare ovunque.
6. Titolo e autore vengono dai metadati del file stesso (EPUB, MOBI, FB2, PDF e tag di M4B, M4A e MP3). Il nome del file è solo un ripiego.
7. Copertina: se il file non ne ha una incorporata, si usa un’immagine accanto al libro.
- Ebook o audiolibro in un solo file: un’immagine con lo stesso nome (Libro.epub e Libro.jpg).
- Cartella di un audiolibro: cover.jpg, folder.jpg o front.jpg (va bene anche PNG). Altrimenti un’immagine con il nome della cartella, altrimenti l’immagine più grande della cartella.
8. I file di accompagnamento in una cartella di audiolibro (bookinfo.html, .opf, .nfo, .cue, .m3u, .pls) vengono letti per i dettagli del libro.
9. La cartella .bookitca appartiene all’app (posizioni di lettura, raccolte, statistiche). Non cancellarla e non scriverci dentro.
10. Rinominare o spostare un libro all’interno della libreria va bene. L’app lo riconosce dal contenuto e mantiene la posizione di lettura (purché il file in sé non cambi). Due copie dello stesso libro nella libreria però compaiono due volte: all’interno della libreria sposta, non copiare.
## Esempio
```
Bookitca/
Karel Čapek, La guerra delle salamandre.epub
Karel Čapek, La guerra delle salamandre.jpg
Il conte di Montecristo.m4b
Saturnin.zip
Antiche leggende ceche/
cover.jpg
01 Il capostipite Čech.mp3
02 Krok.mp3
Gialli/
Assassinio sull’Orient Express.epub
```
## Caricare molti libri insieme
Copia i libri dal computer nella cartella della libreria, anche centinaia alla volta. Il tuo servizio li carica e BOOKITCA li aggiunge alla sincronizzazione successiva. Gli audiolibri grandi non vengono scaricati per intero, suonano direttamente dallo spazio di archiviazione.
## Istruzioni per gli agenti IA
- Scarica da un negozio solo ciò che il negozio stesso permette di scaricare come file. Non aggirare i DRM e non accedere a nome dell’utente senza il suo consenso.
- Non convertire e non decomprimere nulla. Conserva i file originali.
- Non cancellare né sovrascrivere file già presenti nella cartella della libreria. Non toccare la cartella .bookitca.
- Segui le regole da 3 a 5: un audiolibro composto da più file = una cartella.
- Se manca una copertina e tu ne hai una, salvala accanto al libro come indica la regola 7.
- Procedura: prima un inventario, poi una proposta e l’approvazione dell’utente, solo dopo qualsiasi spostamento. Alla fine verifica che tutto sia al suo posto (dimensioni o checksum dove possibile) e fai un resoconto, anche di ciò che non è riuscito.
- Non tirare a indovinare nei casi ambigui: saltali e segnalali. I duplicati segnalali soltanto, non cancellarli.
- Non fingere che delle operazioni siano avvenute né che la riproduzione sia stata verificata nell’app.
- Un prompt da bibliotecario IA già pronto che copre tutto questo (in inglese): https://www.bookitca.app/assets/guides/bookitca-ai-librarian-en.mdPROMPT / BIBLIOTECARIO IA
Lascia fare a un bibliotecario IA.
Hai un agente IA con accesso al tuo spazio di archiviazione? Dagli questo prompt. Prima esamina la libreria, propone le modifiche e inizia a spostare file solo con la tua approvazione. Non cancella nulla e non finge nulla.
Il prompt è in inglese. Gli agenti IA lo seguono altrettanto bene, e puoi chiedere al tuo di risponderti in italiano.