BookOrbit: la tua libreria self hosted (e come leggerla sull'Xteink)
Progetto Hydratech6 min di letturaUna libreria digitale tutta tua, sul tuo server, e un e-reader che scarica i libri da solo e ricorda a che pagina sei arrivato. Qui vediamo come mettere insieme BookOrbit e un Xteink con il firmware CrossPoint.
Come funziona
BookOrbit è una libreria digitale self hosted: gestisce ebook, PDF, audiobook e fumetti, completa i metadati dei libri e parla con Kobo e KOReader. Il lettore Xteink, con CrossPoint al posto del firmware originale, si collega alla libreria con due strumenti diversi:
| Strumento | A cosa serve | Dove si imposta sul lettore |
|---|---|---|
| OPDS | È il catalogo della libreria: dal lettore sfogli i libri e li scarichi | Settings → System → OPDS Servers |
| KOReader Sync | Sincronizza il punto esatto in cui sei arrivato nel libro | Settings → System → KOReader Sync |
Serve impostarli tutti e due: OPDS porta i libri sul lettore, KOReader Sync tiene allineato l'avanzamento.
1. Installare BookOrbit con l'Helper Script
Apri la shell del nodo Proxmox e lancia lo script della community per BookOrbit:
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/bookorbit.sh)"Lo script crea un nuovo container LXC e ci installa BookOrbit. Con le impostazioni predefinite il container è non privilegiato, basato su Debian 13, con 2 vCPU, 4 GB di RAM e 10 GB di disco. I 10 GB sono pochi se la libreria cresce: ingrandisci il disco o dedica un'unità ai libri.
Primo accesso
- Ricava l'indirizzo IP del container (scheda Summary del container in Proxmox).
- Apri
http://IP-DEL-CONTAINER:3000nel browser. - Per il setup iniziale serve il token di bootstrap: lo trovi alla fine di questo file, dalla console del container.
cat /root/bookorbit.credsCon il token crei l'account amministratore. I dati dell'app stanno in /opt/bookorbit-data, i libri in /opt/bookorbit-books.
Per aggiornare BookOrbit in seguito, dalla console del container lancia update: gli Helper Script installano questo comando.
2. Preparare BookOrbit per il lettore
- Attiva OPDS. In Settings → OPDS accendi l'interruttore OPDS Catalog Server. Se è spento, BookOrbit rifiuta tutte le richieste OPDS.
- Crea un account OPDS. Il lettore non usa il tuo login normale: nella sezione OPDS Accounts crei un account apposta (username di almeno 3 caratteri, password di almeno 8). Conviene un account per ogni dispositivo, così puoi revocarlo da solo.
- Copia gli indirizzi. La pagina KOReader delle impostazioni di BookOrbit mostra gli indirizzi da usare per OPDS e per KOReader Sync. Servono nel passo 4.
L'indirizzo del catalogo OPDS è quello del tuo server seguito da /api/v1/opds. Puoi usare l'indirizzo locale oppure un dominio tuo, per esempio con Nginx Proxy Manager. In quel caso ricordati di aggiungere in fondo il percorso del catalogo:
http://192.168.1.50:3000/api/v1/opds
https://libri.tuodominio.it/api/v1/opds3. Installare CrossPoint sull'Xteink
CrossPoint è un firmware open source sviluppato dalla community, non da Xteink, per i lettori Xteink X3 e X4. Si installa dal browser con il flasher del sito ufficiale.
- Collega il lettore al computer con un cavo USB-C che trasferisce dati (alcuni cavi servono solo per caricare) e sveglia o sblocca lo schermo.
- Apri crosspointreader.com/#flash-tools con un browser basato su Chromium (Chrome o Edge): il flasher usa la porta seriale del browser, che Safari e Firefox non supportano.
- Scegli il tuo dispositivo e una release ufficiale di CrossPoint.
- Nella finestra del browser seleziona la porta del lettore e avvia l'installazione. Non scollegare il cavo finché non finisce.
Se il lettore non compare tra le porte, prova un'altra porta USB, un altro cavo o un altro browser. Solo se ancora non compare esiste lo strumento di sblocco, ma leggi prima l'avviso del progetto: supporta solo CrossPoint e CrossInk, e flashare altro su un lettore bloccato può renderlo inutilizzabile.
Per tornare al firmware originale si usa la stessa pagina, flashando l'ultimo firmware ufficiale. Se vuoi installare una versione specifica, scarica il file firmware.bin dalle release e caricalo con l'opzione Custom .bin.
4. Collegare il lettore a BookOrbit
Prima di tutto il lettore deve conoscere la tua rete Wi-Fi: Settings → System → Wi-Fi Networks.
OPDS: per scaricare i libri
- Vai in Settings → System → OPDS Servers e scegli Add Server.
- Compila il nome (facoltativo), l'OPDS Server URL con l'indirizzo che termina in
/api/v1/opds, e username e password dell'account OPDS creato prima.
http://crosspoint.local (oppure http://IP-DEL-LETTORE/settings): nella scheda OPDS Servers inserisci tutto con la tastiera.
KOReader Sync: per sincronizzare l'avanzamento
- Vai in Settings → System → KOReader Sync.
- Inserisci username e password e, come indirizzo del server, quello che BookOrbit mostra nella pagina KOReader delle impostazioni.
- Nel video abbiamo impostato il confronto dei documenti su Binary (così il lettore riconosce il file direttamente), attivato l'invio dei metadati del documento e scelto Smart sync, che decide da solo se caricare o scaricare l'avanzamento.
- Premi Authenticate. Non serve Sign Up: serve a creare un account su un server di sincronizzazione, mentre qui l'account è quello di BookOrbit.
5. Usarlo ogni giorno
Scaricare un libro
Dalla home del lettore apri OPDS Browser: il lettore si collega al Wi-Fi e mostra il catalogo di BookOrbit. Scegli All Books, poi il libro da scaricare. Il catalogo ha anche sezioni come libri recenti, autori e serie.
Sincronizzare l'avanzamento
- Con un libro aperto premi il tasto centrale per far comparire il menu.
- Scorri fino a Sync Progress e premilo: il lettore si collega al Wi-Fi e sincronizza.
- In BookOrbit, nella pagina KOReader, il lettore compare tra i dispositivi con l'ora dell'ultima sincronizzazione.
In alternativa, impostando Settings → Controls → Long-press Menu su KOSync, tenendo premuto il tasto centrale per circa un secondo la sincronizzazione parte direttamente.
Dove prendere i libri
La cartella dei libri di BookOrbit è /opt/bookorbit-books. C'è anche una sezione Requests che si può collegare a servizi esterni come Prowlarr per cercare e scaricare un titolo richiesto: lo stato passa ad Approved e il libro arriva da solo nella libreria. Usa solo libri che hai il diritto di avere: acquistati senza DRM, di tua proprietà o liberi da diritti.
Com'è andata
Nel video BookOrbit ha funzionato al primo tentativo, meglio di Calibre-Web nella nostra esperienza. L'unico punto scomodo è inserire username e password sul lettore con i tasti: per quello usa la pagina web del lettore descritta sopra.
Link utili
- BookOrbit sugli Helper Script e il sito di BookOrbit (installazione, OPDS, KOReader)
- Sito di CrossPoint e la guida sul repository
- Il video su YouTube
Nota: i menu possono cambiare con le nuove versioni, in caso di dubbio fai fede alle pagine ufficiali. Procedi a tuo rischio.