Come configurare OPDS su iPhone e iPad

Risposta rapida: Per configurare OPDS su iPhone o iPad, installa un'app di lettura con supporto OPDS, apri la sezione cataloghi, aggiungi un nuovo catalogo incollando l'URL OPDS del server (ad esempio http://192.168.1.10:8080/opds per un Calibre Content Server) e inserisci nome utente e password solo se il server lo richiede. L'app mostra tutto ciò che il server contiene, pronto da scaricare e leggere offline.

OPDS è una di quelle funzioni che sembrano tecniche e in realtà richiedono circa due minuti. Questa guida spiega cos'è OPDS, cosa serve per connettersi e come configurare il primo catalogo su iPhone o iPad, che si tratti di una biblioteca pubblica gratuita come Project Gutenberg o del proprio server Calibre di casa.

Cos'è OPDS?

OPDS (Open Publication Distribution System) è uno standard semplice che permette a un'app di lettura di sfogliare e scaricare libri da un server. Funziona come un feed RSS, ma per una biblioteca di ebook invece che per le notizie. Punti l'app verso un indirizzo, l'URL del catalogo, e l'app mostra tutti i libri disponibili sul server, con copertine, autori e descrizioni. Tocchi un libro, lo scarichi e lo leggi.

Essendo uno standard aperto, OPDS funziona con fonti molto diverse. La stessa app può connettersi a una biblioteca di pubblico dominio, a un server multimediale casalingo pieno di fumetti e alla tua raccolta personale in Calibre, tutto tramite lo stesso meccanismo. La maggior parte di app e server oggi supporta OPDS 1.2. Esiste una versione più recente basata su JSON, OPDS 2.0, che comincia ad apparire (Komga la supporta già), ma nella pratica userai la 1.2.

Cosa serve per connettersi

Per connettersi a qualsiasi catalogo OPDS bastano due cose, spesso solo la prima:

1. L'URL del catalogo. È l'endpoint OPDS, di solito termina con /opds o simile. Per un catalogo pubblico è pubblicato sul sito del progetto. Per il proprio server è l'indirizzo del server più il percorso OPDS.
2. Nome utente e password, solo se richiesti. I cataloghi pubblici sono aperti. I server privati, come il proprio Calibre o Komga, possono richiedere un login. In tal caso lo inserisci una volta sola e l'app lo ricorda.

Questo è tutto. Nessun account, nessun servizio di sincronizzazione di terze parti, nessun trasferimento manuale di file.

Passo 1: Installa un'app di lettura OPDS

iOS non naviga i cataloghi OPDS da solo, quindi hai bisogno di un'app di lettura che lo supporti. justRead è un lettore EPUB e PDF per iPhone e iPad con OPDS integrato, incluso un catalogo Project Gutenberg preinstallato, ricerca lato server e supporto per server personalizzati. Qualunque app scegli, cerca una sezione OPDS o Cataloghi nella libreria o nelle impostazioni.

Passo 2: Aggiungi il primo catalogo (Project Gutenberg)

Il modo più semplice per vedere OPDS in azione è un catalogo pubblico gratuito. Project Gutenberg offre più di 70.000 libri di pubblico dominio tramite un feed OPDS all'indirizzo:

https://www.gutenberg.org/ebooks/search.opds/

In justRead, Project Gutenberg è già integrato, quindi puoi aprirlo direttamente senza digitare nulla. In altre app, apri la sezione OPDS, scegli Aggiungi catalogo, incolla l'URL sopra e salva. L'app carica il catalogo e puoi sfogliarlo o cercare un autore o un titolo, poi scaricare quello che vuoi. Tutto ciò che si trova su Gutenberg è gratuito e legale.

Passo 3: Connetti un Calibre Content Server

Il catalogo privato più diffuso è la propria libreria Calibre. Calibre, il gestore gratuito di ebook per desktop, può pubblicare l'intera raccolta via OPDS con pochi clic:

1. Sul computer, apri Calibre e clicca su Connetti/condividi nella barra degli strumenti.
2. Scegli Avvia Content Server.
3. Annota l'indirizzo IP locale del computer (qualcosa come 192.168.1.10). L'endpoint OPDS è quindi http://192.168.1.10:8080/opds, dove 8080 è la porta predefinita di Calibre.

Su iPhone o iPad, aggiungi quell'URL come nuovo catalogo OPDS. justRead può anche scoprire automaticamente un Calibre Content Server sulla stessa rete Wi-Fi e supporta l'autenticazione HTTP Digest se hai attivato l'opzione "Richiedi nome utente e password" in Calibre. Per un flusso di lavoro più completo che sincronizza progressi di lettura e valutazioni con il computer, consulta la guida dedicata alla sincronizzazione della libreria Calibre. Questo percorso OPDS è il modo più rapido per leggere semplicemente i tuoi libri.

Alcune cose da sapere sul Content Server: Calibre deve restare aperto e in esecuzione affinché il catalogo funzioni, entrambi i dispositivi devono essere sulla stessa rete a meno che non si configuri l'accesso remoto, e se l'IP del computer cambia, cambia anche l'URL del catalogo. Riservare un IP statico nel router evita questo problema.

Passo 4: Connetti un server self-hosted (Komga, Kavita, calibre-web)

Se gestisci un server casalingo, gli stessi passaggi si applicano con l'endpoint OPDS di ciascun progetto:

justRead supporta server OPDS personalizzati tra cui Calibre OPDS, calibre-web, Kavita, Komga e COPS, con filtri e impaginazione per server così anche i cataloghi grandi restano gestibili. Aggiungi il server come nuovo catalogo, inserisci le credenziali se necessario, e i tuoi scaffali appaiono sull'iPhone.

Un dettaglio importante: Kavita non usa nome utente e password separati per OPDS. Incorpora invece una chiave di autenticazione nell'URL stesso (la parte <tua-chiave> sopra). Copia l'URL completo già pronto dalle impostazioni di Kavita, incollalo come URL del catalogo e lascia vuoti i campi nome utente e password.

Problemi comuni e soluzioni

• L'app non riesce a raggiungere il server. Verifica che entrambi i dispositivi siano sulla stessa rete Wi-Fi, che il software del server sia in esecuzione e che tu abbia usato http:// con la porta corretta. Il solito colpevole è il firewall del computer che blocca la porta.
• Chiede un login che non conosci. Il server ha l'autenticazione attiva. Usa le stesse credenziali impostate sul server, oppure disattiva il requisito per l'uso in rete locale.
• Un server remoto non si connette via HTTPS. iOS rifiuta i certificati autofirmati a meno che non li installi e li accetti esplicitamente nelle Impostazioni. Per l'accesso remoto, un certificato valido (ad esempio tramite un dominio e Let's Encrypt) è la strada più affidabile.
• Il catalogo funzionava ieri e oggi no. L'IP locale del server probabilmente è cambiato. Riserva un IP statico, oppure usa il nome host .local del computer invece dell'indirizzo numerico.

Dove si inserisce OPDS nel tuo setup di lettura

OPDS trasforma iPhone o iPad in un front-end per qualsiasi libreria tu possa indicargli, pubblica o privata, senza copiare file a mano. Una volta configurato, scaricare un nuovo libro richiede due tocchi. Per approfondire la connessione di cataloghi e server, consulta la panoramica del lettore OPDS, e se i tuoi libri si trovano in Calibre, il flusso di sincronizzazione Calibre aggiunge la sincronizzazione bidirezionale di progressi e valutazioni. Sei nuovo agli ebook su iOS in generale? Inizia con come leggere EPUB su iPhone e iPad.

Scarica justRead dall'App Store e configura il tuo primo catalogo OPDS oggi.

Domande frequenti

Cos'è un catalogo OPDS?

Un catalogo OPDS è un feed che permette a un'app di lettura di sfogliare e scaricare libri da un server, in modo simile a come un lettore RSS si iscrive a un feed di notizie. Punti l'app verso l'URL del catalogo e questo elenca tutti i libri disponibili sul server, pronti da scaricare.

L'uso di OPDS è gratuito?

OPDS è uno standard aperto e gratuito. Molti cataloghi pubblici, come Project Gutenberg, sono gratuiti e legali da cui scaricare. Server privati come il proprio Calibre o Komga sono gratuiti da gestire autonomamente.

Ho bisogno di Calibre per usare OPDS su iPhone?

No. Puoi connetterti a cataloghi pubblici come Project Gutenberg senza alcun server. Il Content Server di Calibre è solo una fonte OPDS popolare, utile se già gestisci la tua libreria in Calibre su un computer.

Perché il mio server OPDS non si connette su iOS?

Le cause più comuni sono che i due dispositivi si trovano su reti diverse, il software del server non è in esecuzione, un firewall blocca la porta, o un certificato HTTPS autofirmato non è riconosciuto da iOS. Per un server Calibre locale, controlla l'indirizzo IP e la porta e assicurati che Calibre sia aperto.