OPDS di calibre-web su iPhone e iPad: l'indirizzo esatto e il login

Risposta rapida: il feed OPDS di calibre-web si trova su http://<tuo-server>:8083/opds. Richiede lo stesso nome utente e la stessa password che usi per l'interfaccia web di calibre-web, tramite autenticazione HTTP Basic, e la sessione del browser non viene riutilizzata, quindi le digiti di nuovo nell'app di lettura. Calibre-Web-Automated usa esattamente lo stesso indirizzo e lo stesso login. Aggiungi quell'URL come catalogo OPDS personalizzato in un lettore su iPhone o iPad e la tua libreria Calibre è lì.

Tutto quanto segue è stato verificato il 24 agosto 2026 su calibre-web 0.6.27 e Calibre-Web-Automated v4.0.6, entrambi eseguiti dalle rispettive immagini ufficiali contro una vera libreria Calibre, non copiato dalla documentazione.

L'indirizzo, e le tre cose che vanno storte

1. La sessione web non autentica il feed

È questo il dettaglio che inganna chi ha calibre-web aperto in una scheda del browser e presume che il lettore venga lasciato entrare allo stesso modo. Non funziona così. Il feed usa l'autenticazione Basic, del tutto separata dal cookie che il browser conserva, e restituisce 401 con un'intestazione WWW-Authenticate finché non fornisci un nome utente e una password.

È una buona notizia per la configurazione: qualsiasi lettore OPDS che supporti nome utente e password si connetterà. In justRead, aggiungi il server una volta con l'URL, il nome utente e la password, e vengono ricordati.

2. Un reindirizzamento al posto di un feed significa server non configurato

Prima che calibre-web venga puntato verso un database Calibre, ogni percorso, incluso /opds, restituisce un 302 verso /admin/dbconfig. Se il tuo lettore segnala qualcosa di strano invece di chiedere una password, apri http://<tuo-server>:8083/ in un browser. Se ti manda a una pagina di configurazione del database, l'URL non era il problema: un amministratore deve prima impostare il percorso della libreria Calibre.

Calibre-Web-Automated non ha questo problema. Arriva con una libreria già configurata e serve OPDS al primo avvio, utile da sapere se stai scegliendo tra i due e vuoi il telefono funzionante oggi stesso.

3. Porta 8083, non 8080

8080 è il Calibre Content Server, un programma diverso da calibre-web, che trattiamo nella guida al Calibre Content Server. I due vengono continuamente confusi, e scambiare le porte produce un errore di connessione che sembra un problema di rete.

Differiscono anche sull'autenticazione in un modo che qui conta: il Calibre Content Server non ha nessuna autenticazione per impostazione predefinita, mentre calibre-web la richiede sempre. Se il tuo lettore si è connesso a un server "tipo Calibre" senza chiedere una password, quello era il Content Server.

Cosa ottieni una volta connesso

La radice OPDS di calibre-web serve quindici sezioni. Tutte e quindici erano presenti in entrambe le versioni testate:

Libri in ordine alfabetico, Libri più letti, Libri più votati, Libri aggiunti di recente, Libri casuali, Libri letti, Libri non letti, Autori, Editori, Categorie, Serie, Lingue, Valutazioni, Formati file, Scaffali.

È la stessa struttura dell'interfaccia web, ed è proprio questo il punto: i metadati che hai curato in Calibre, le serie, le valutazioni, gli scaffali personalizzati, arrivano intatti invece di appiattirsi in un unico lungo elenco.

La ricerca è esposta due volte, come /opds/search/{searchTerms} con template e come descrittore OpenSearch su /opds/osd, così un lettore che supporta la ricerca lato server può interrogare il server invece di scaricare tutto e cercare in locale. Questa differenza conta parecchio con qualche migliaio di libri.

calibre-web vs Calibre-Web-Automated: cosa cambia davvero

Calibre-Web-Automated è un fork sviluppato attivamente che aggiunge importazione automatica, conversione e gestione dei metadati sopra calibre-web. La domanda ovvia per un telefono è se il suo feed OPDS sia diverso.

Abbiamo eseguito entrambi fianco a fianco e confrontato i feed. La risposta è: stesso URL, stessa autenticazione, ed esattamente una sezione in più.

Calibre-Web Automated      (titolo del feed)
Calibre-Web

Magic Shelves              (presente solo in CWA)

Tutto il resto è identico: /opds, HTTP Basic, e le stesse quindici sezioni nello stesso ordine. Tutto ciò che vale per l'OPDS di calibre-web vale anche per quello di CWA.

L'unica differenza pratica non riguarda affatto il feed. CWA arriva con una libreria configurata e risponde al primo avvio; il semplice calibre-web reindirizza tutto a /admin/dbconfig finché qualcuno non imposta il percorso del database.

Collegarlo su un iPhone o un iPad

1. Trova l'indirizzo del server sulla rete. Un IP locale come 192.168.1.20, oppure un nome host se ne hai uno. Fissalo nelle prenotazioni DHCP del router, altrimenti l'indirizzo cambia e il catalogo smette di funzionare senza motivo apparente.
2. Conferma il feed prima in un browser. Apri http://<tuo-server>:8083/opds. Dovresti ricevere una richiesta di nome utente e password, e poi vedere un muro di XML. Se vieni reindirizzato a una pagina di configurazione, torna al punto 2 sopra.
3. Aggiungilo nel tuo lettore come catalogo OPDS personalizzato: l'URL, il tuo nome utente di calibre-web, la tua password di calibre-web.
4. Sfoglia e scarica. OPDS consegna i file invece di trasmettere pagine, quindi un libro viene scaricato sul dispositivo e letto lì. Questo significa anche che continua a funzionare quando sei lontano dal server, e che la tua posizione di lettura resta sul telefono invece di sincronizzarsi con calibre-web.

Per la versione generale di questi passaggi su qualsiasi server, vedi come configurare OPDS su iPhone e iPad.

Raggiungerlo da fuori casa

Dentro la tua rete, l'HTTP semplice va benissimo ed è la soluzione più semplice che funziona.

Da fuori, non limitarti a inoltrare la porta 8083. Due approcci valgono lo sforzo:

• Un reverse proxy con un certificato vero. Caddy o nginx davanti a calibre-web, con un certificato di Let's Encrypt, ti dà un HTTPS di cui iOS si fida senza alcuna configurazione sul dispositivo.
• Una VPN o una rete mesh verso la tua LAN, dopodiché l'indirizzo locale funziona invariato da qualunque posto.

Ciò che non funziona senza attenzione è un certificato autofirmato. iOS lo rifiuta a meno che il certificato non sia installato sul dispositivo e approvato esplicitamente in Impostazioni, Generali, Info, Impostazioni di attendibilità certificati. Fino ad allora la connessione fallisce semplicemente, e il fallimento sembra esattamente un server spento piuttosto che un problema di certificato.

I problemi più comuni, nell'ordine in cui capitano di solito

"Chiede una password e rifiuta quella giusta." calibre-web ha i propri account utente, separati da qualsiasi login del sistema operativo. Usa l'account con cui accedi all'interfaccia web di calibre-web. Quello predefinito su un'installazione nuova è admin con password admin123, che dovresti cambiare prima che qualcosa sia raggiungibile dall'esterno.

"Ottengo un reindirizzamento, non un feed." Il percorso del database non è configurato. Vedi sopra.

"Funzionava ieri e oggi no." Quasi sempre l'indirizzo IP del server è cambiato. Riservalo nel router.

"Il catalogo è vuoto." calibre-web punta a una libreria Calibre senza libri, oppure a una cartella che non è una libreria Calibre. Anche l'interfaccia web apparirà ugualmente vuota; controlla lì per primo, perché il feed riflette solo ciò che calibre-web stesso riesce a vedere.

"Alcuni libri non si scaricano." calibre-web serve i formati presenti nella tua libreria Calibre. Se un libro esiste solo come AZW3 o MOBI, convertilo in EPUB in Calibre sul computer, e il formato convertito comparirà nel feed.

Dove si colloca tra le altre opzioni

Se i tuoi libri sono in Calibre e li vuoi su un iPhone, ci sono tre strade e sono davvero diverse:

• calibre-web, questa pagina: un front-end web che gira senza tenere aperta l'app desktop Calibre, con account utente e un feed OPDS su :8083/opds.
• Il Calibre Content Server, su :8080/opds, integrato in Calibre stesso e che richiede l'app desktop o calibre-server in esecuzione. Non ha autenticazione finché non la attivi. Vedi la guida al Content Server.
• Una cartella cloud o la copia diretta dei file, che non richiede alcun server. Vedi come sincronizzare Calibre con iPhone e iPad.

justRead si collega a tutti e tre, oltre che a Komga, Kavita, COPS e a qualsiasi altro server OPDS, con filtri e paginazione per server così una libreria grande resta gestibile sul telefono. La pagina lettore OPDS riporta l'URL verificato e il metodo di autenticazione per ogni server che abbiamo testato, e l'elenco dei cataloghi OPDS gratuiti copre i cataloghi pubblici anziché la tua libreria personale.

Scarica justRead dall'App Store e punta l'app verso il tuo server calibre-web.