Per iniziare con Jinbocho¶

Benvenuto in Jinbocho, il tuo sistema di gestione della biblioteca domestica. Questa guida ti aiuterà a configurare la tua biblioteca e iniziare a catalogare i libri in pochi minuti.

Cos'è Jinbocho?¶

Jinbocho è un sistema digitale di gestione della biblioteca domestica. Ti permette di:

Catalogare i tuoi libri fisici in più stanze e librerie
Cercare e filtrare la tua biblioteca istantaneamente
Tracciare i progressi di lettura, le valutazioni e i consigli AI personalizzati per i libri che possiedi
Organizzare le posizioni (stanze → librerie → scaffali)
Condividere con altre persone e invitarle a collaborare sulla stessa biblioteca
Esportare e fare backup dei tuoi dati in qualsiasi momento

Che tu abbia 10 libri o 10.000, Jinbocho ti aiuta a organizzare, trovare e gestire la tua collezione.

Requisiti di sistema¶

Browser supportati¶

Jinbocho funziona su qualsiasi browser moderno:

Chrome (v90+)
Firefox (v88+)
Safari (v14+)
Edge (v90+)

Supporto mobile¶

Jinbocho è completamente responsive e funziona su:

iPhone/iPad (iOS 12+, Safari)
Smartphone/tablet Android (Chrome, Firefox)

Connessione internet¶

Jinbocho richiede una connessione attiva. Non è disponibile una modalità offline.

Accedere a Jinbocho¶

Apri il browser e vai all'URL della tua installazione di Jinbocho. Se è la prima volta, vedrai la schermata di login. Clicca "Non hai un account? Registrati" per creare la tua biblioteca.

Creare la tua biblioteca¶

Passo 1: compila i dati¶

Il modulo di registrazione chiede:

Campo	Esempio	Note
Nome biblioteca	"Biblioteca Rossi"	Nome della tua collezione, visibile a chiunque inviti
Il tuo nome	"Marco"	Il tuo nome personale nella biblioteca
Email	"marco@esempio.it"	Per il login e recupero password
Password	(nascosta)	Minimo 8 caratteri
Privacy e Termini	(casella di spunta)	Devi accettare l'attuale Privacy Policy e i Termini di Servizio per registrarti

Passo 2: crea la biblioteca¶

Clicca "Registrati". La biblioteca viene creata immediatamente.

Cosa succede subito dopo:

Diventi l'Admin della tua nuova biblioteca (accesso completo)
Puoi invitare altre persone a farne parte
La biblioteca è vuota (pronta per aggiungere libri)

Passo 3: accedi¶

Dopo la registrazione potrebbe essere richiesto di accedere:

Inserisci la tua email
Inserisci la password
Clicca "Accedi"

Sei dentro la tua dashboard Jinbocho.

Sei già membro di un'altra biblioteca?

Se l'email con cui ti sei registrato appartiene anche a una biblioteca a cui qualcun altro ti ha invitato, dopo il login vedrai un selettore di biblioteche invece di andare direttamente alla dashboard. Vedi Autenticazione → Appartenere a più biblioteche.

Il primo sguardo all'app¶

Barra di navigazione¶

Su desktop (barra laterale sinistra): - Dashboard — panoramica della biblioteca - Libri — catalogo completo - Posizioni — stanze e librerie - Statistiche — progressi di lettura - Prestiti — libri in prestito - Utenti — gestione membri - Impostazioni — preferenze e profilo

Su mobile (barra inferiore): - Icone per le sezioni principali - Il menu hamburger (☰) in alto apre la navigazione completa

Aggiungere il primo libro¶

Opzione 1: scansione ISBN (più veloce)¶

Clicca "Aggiungi libro" → "Scansiona ISBN"
Consenti l'accesso alla fotocamera quando richiesto
Punta la fotocamera sul codice a barre del libro
L'app riconosce l'ISBN e cerca i metadati automaticamente
Controlla titolo, autore, copertina
Scegli dove mettere il libro (stanza → libreria → scaffale)
Clicca "Salva"

Opzione 2: inserimento manuale¶

Se la scansione non funziona:

Clicca "Aggiungi libro" → "Inserimento manuale"
Digita titolo, autore, ISBN (opzionale), editore, anno
Scegli la posizione nella biblioteca
Clicca "Salva"

Opzione 3: fotografa un intero scaffale¶

Se hai già diversi libri sistemati su uno scaffale e vuoi aggiungerli tutti in una volta, scatta una sola foto invece di scansionare libro per libro — l'AI di Jinbocho legge ogni dorso visibile e propone ogni titolo perché tu lo confermi. Vedi Scansione ISBN → Scansione scaffale per la procedura completa (richiede l'AI attiva sulla tua istanza).

Opzione 4: da un backup o da Goodreads¶

Se hai un backup Jinbocho precedente, o un export da Goodreads:

Vai su Impostazioni → "Backup e ripristino" (backup Jinbocho) o "Dati biblioteca" (import Goodreads) — solo admin/editor
Carica il file
Controlla e conferma l'importazione
I libri appaiono immediatamente

Vedi Esportazione per i dettagli su entrambi.

Organizzare la biblioteca (primo setup)¶

Prima di aggiungere molti libri, crea le tue posizioni:

Passo 1: crea una stanza¶

Vai su Posizioni (barra laterale)
Clicca "Nuova stanza"
Inserisci il nome: "Salotto", "Camera", "Studio", ecc.
Clicca "Crea"

Passo 2: crea una libreria¶

Clicca sulla stanza appena creata
Clicca "Nuova libreria"
Inserisci il nome: "Billy IKEA", "Libreria grande", ecc.
Clicca "Crea"

Passo 3: inizia ad aggiungere libri¶

Ora puoi: 1. Aggiungere libri via scansione, inserimento manuale o foto dell'intero scaffale 2. Assegnare ogni libro a uno scaffale preciso 3. Vedere la biblioteca riempirsi!

Invitare altri membri (opzionale)¶

Solo gli Admin possono invitare nuovi membri.

Per invitare qualcuno¶

Vai su Impostazioni → Utenti
Clicca "Invita utente"
Inizia a digitare nome o email della persona — se ha già un account Jinbocho, comparirà in un elenco di suggerimenti (selezionala direttamente); altrimenti, inserisci la sua email come testo libero
Scegli il ruolo:
Admin: accesso completo (gestione utenti, posizioni, impostazioni)
Editor: può aggiungere/modificare libri e posizioni
Viewer: sola lettura (può sfogliare i libri)
Clicca "Invia invito"

Se la persona non ha ancora un account Jinbocho, riceverà un'email con un link di registrazione. Se lo ha già, l'invito comparirà nel suo selettore di biblioteche al prossimo accesso, dove potrà accettarlo o rifiutarlo — vedi Autenticazione → Appartenere a più biblioteche.

Consigli per iniziare bene¶

📱 Scansione da mobile¶

Tieni il libro all'altezza degli occhi
Assicurati di avere buona illuminazione
Mantieni il codice a barre centrato nell'inquadratura
La scansione avviene automaticamente — nessun pulsante da toccare

🔍 Usare la ricerca¶

Cerca per titolo, autore, ISBN o note
Usa i filtri per restringere i risultati (stanza, stato di lettura, lingua)

👥 Condividere una biblioteca¶

Ogni membro vede la stessa biblioteca
Puoi vedere chi ha aggiunto ogni libro
Note e stato di lettura sono personali (non condivisi di default)
Ogni membro può avere un ruolo diverso in biblioteche diverse a cui appartiene

📤 Fai il backup dei tuoi dati¶

Vai su Impostazioni → "Backup e ripristino"
Scarica un backup completo quando vuoi
I tuoi dati sono tuoi — tienine una copia offline

Domande comuni¶

D: I miei dati sono al sicuro?
R: Tutti i dati sono criptati in transito (HTTPS) e archiviati su server cloud sicuri. Vedi Domande frequenti per maggiori dettagli.

D: Posso usare Jinbocho offline?
R: Non ancora.

D: Posso condividere la mia biblioteca con persone fuori dal mio nucleo familiare?
R: Sì — una biblioteca non è limitata alla famiglia. Invita chiunque per email o username, e assegnagli un ruolo.

D: Come cambio la password?
R: Vai sul tuo profilo (clicca il tuo nome/avatar) → "Cambia password".

D: Come lascio una biblioteca?
R: Chiedi a un Admin di rimuoverti come membro, oppure — se sei l'unico Admin — promuovi prima un altro membro.

Prossimi passi¶

✅ Hai creato la tua biblioteca
📚 Poi: leggi Autenticazione e account per capire login, password, sessioni e appartenenza a più biblioteche
🎯 Poi: scopri come Gestire la biblioteca

Buona catalogazione! 📖

Hai bisogno di aiuto? Consulta Risoluzione problemi o Domande frequenti.