calibre-web OPDS sur iPhone et iPad : l'URL exacte et la connexion

Réponse rapide : le flux OPDS de calibre-web se trouve à http://<your-server>:8083/opds. Il demande le même identifiant et le même mot de passe que ceux de l'interface web de calibre-web, via une authentification HTTP Basic, et votre session de navigateur n'est pas reprise, vous devez donc les retaper dans l'application de lecture. Calibre-Web-Automated utilise exactement la même adresse et la même connexion. Ajoutez cette URL comme catalogue OPDS personnalisé dans une application de lecture sur votre iPhone ou iPad et votre bibliothèque Calibre apparaît.

Tout ce qui suit a été vérifié le 24 août 2026 avec calibre-web 0.6.27 et Calibre-Web-Automated v4.0.6, tous deux exécutés à partir de leurs images officielles face à une vraie bibliothèque Calibre, plutôt que recopié depuis la documentation.

L'adresse, et les trois choses qui posent problème

1. La session web n'authentifie pas le flux

C'est ce qui piège les personnes qui ont calibre-web ouvert dans un onglet de navigateur et pensent que l'application de lecture sera admise de la même façon. Ce n'est pas le cas. Le flux utilise l'authentification Basic, entièrement séparée du cookie que détient votre navigateur, et il renvoie 401 avec un en-tête WWW-Authenticate tant que vous ne fournissez pas un identifiant et un mot de passe.

C'est une bonne nouvelle pour la configuration : n'importe quelle application de lecture OPDS qui accepte identifiant et mot de passe se connectera. Dans justRead, vous ajoutez le serveur une seule fois avec l'URL, l'identifiant et le mot de passe, et ils sont mémorisés.

2. Une redirection au lieu d'un flux signifie que le serveur n'est pas configuré

Avant que calibre-web ne soit pointé vers une base de données Calibre, tous les chemins, y compris /opds, renvoient un 302 vers /admin/dbconfig. Si votre application de lecture signale quelque chose d'étrange plutôt que de demander un mot de passe, ouvrez http://<your-server>:8083/ dans un navigateur. Si vous êtes redirigé vers une page de configuration de base de données, l'URL n'a jamais été le problème : un administrateur doit d'abord définir le chemin de la bibliothèque Calibre.

Calibre-Web-Automated n'a pas ce problème. Il arrive avec une bibliothèque déjà configurée et sert l'OPDS dès le premier démarrage, ce qui vaut la peine d'être su si vous hésitez entre les deux et voulez que le téléphone fonctionne aujourd'hui même.

3. Le port 8083, pas 8080

8080 est celui du Calibre Content Server, un programme différent de calibre-web, que nous couvrons dans le guide du Calibre Content Server. Les deux sont constamment confondus, et confondre leurs ports produit un échec de connexion qui ressemble à un problème réseau.

Ils diffèrent aussi sur l'authentification, ce qui compte ici : le Calibre Content Server n'a aucune authentification par défaut, tandis que calibre-web l'exige toujours. Si votre application de lecture s'est connectée à un serveur de type Calibre sans demander de mot de passe, c'était le Content Server.

Ce que vous obtenez une fois connecté

La racine OPDS de calibre-web propose quinze sections. Les quinze étaient présentes dans les deux versions testées :

Livres par ordre alphabétique, Livres populaires, Livres les mieux notés, Livres ajoutés récemment, Livres aléatoires, Livres lus, Livres non lus, Auteurs, Éditeurs, Catégories, Séries, Langues, Évaluations, Formats de fichiers, Étagères.

C'est la même structure que l'interface web, ce qui est le but : les métadonnées que vous avez soignées dans Calibre, les séries, les évaluations, les étagères personnalisées, sont conservées plutôt que d'être aplaties en une seule longue liste.

La recherche est exposée deux fois, sous forme d'un modèle /opds/search/{searchTerms} et d'un descripteur OpenSearch à /opds/osd, de sorte qu'une application de lecture qui prend en charge la recherche côté serveur peut interroger le serveur au lieu de tout télécharger et de chercher localement. Cette différence compte à partir de quelques milliers de livres.

calibre-web contre Calibre-Web-Automated : ce qui change réellement

Calibre-Web-Automated est un fork activement développé qui ajoute l'ingestion automatique, la conversion et la gestion des métadonnées par-dessus calibre-web. La question évidente pour un téléphone est de savoir si son flux OPDS est différent.

Nous avons fait tourner les deux en parallèle et comparé les flux. La réponse est : même URL, même authentification, et exactement une section supplémentaire.

Calibre-Web Automated      (titre du flux)
Calibre-Web

Magic Shelves              (présent uniquement dans CWA)

Tout le reste est identique : /opds, HTTP Basic, et les mêmes quinze sections dans le même ordre. Tout ce qui est vrai de l'OPDS de calibre-web est vrai de celui de CWA.

La seule différence pratique ne se trouve pas dans le flux. CWA est livré avec une bibliothèque configurée et répond dès le premier démarrage ; calibre-web classique redirige tout vers /admin/dbconfig tant que personne n'a défini le chemin de la base de données.

Connexion depuis un iPhone ou un iPad

1. Trouvez l'adresse de votre serveur sur le réseau. Une IP locale comme 192.168.1.20, ou un nom d'hôte si vous en avez un. Réservez-la dans les réservations DHCP de votre routeur, sinon l'adresse change et le catalogue cesse de fonctionner sans raison visible.
2. Confirmez le flux dans un navigateur d'abord. Ouvrez http://<your-server>:8083/opds. Un identifiant et un mot de passe devraient vous être demandés, puis vous devriez voir un mur de XML. Si vous êtes redirigé vers une page de configuration, revenez au point 2 ci-dessus.
3. Ajoutez-le dans votre application de lecture comme catalogue OPDS personnalisé : l'URL, votre identifiant calibre-web, votre mot de passe calibre-web.
4. Parcourez et téléchargez. OPDS transmet des fichiers plutôt que de diffuser des pages, donc un livre est téléchargé sur l'appareil et lu là. Cela signifie aussi que ça continue de fonctionner quand vous êtes loin du serveur, et que votre position de lecture reste sur le téléphone plutôt que de se synchroniser avec calibre-web.

Pour la version générale de ces étapes sur n'importe quel serveur, voir comment configurer OPDS sur iPhone et iPad.

Y accéder depuis l'extérieur de chez vous

Sur votre propre réseau, le simple HTTP convient et c'est la solution la plus simple qui fonctionne.

Depuis l'extérieur, ne vous contentez pas de rediriger le port 8083. Deux approches valent l'effort :

• Un proxy inverse avec un vrai certificat. Caddy ou nginx devant calibre-web, avec un certificat de Let's Encrypt, vous donne du HTTPS auquel iOS fait confiance sans aucune configuration sur l'appareil.
• Un VPN ou un réseau maillé vers votre propre réseau local, après quoi l'adresse locale fonctionne sans changement depuis n'importe où.

Ce qui ne fonctionne pas au débotté, c'est un certificat auto-signé. iOS en refuse un à moins qu'il ne soit installé sur l'appareil et explicitement approuvé sous Réglages, Général, Informations, Réglages de confiance des certificats. Jusque-là, la connexion échoue tout simplement, et l'échec ressemble exactement à un serveur hors service plutôt qu'à un problème de certificat.

Pannes courantes, dans l'ordre où elles surviennent habituellement

« Il demande un mot de passe et rejette le bon. » calibre-web a ses propres comptes utilisateurs, distincts de toute connexion au système d'exploitation. Utilisez le compte avec lequel vous vous connectez à l'interface web de calibre-web. Par défaut sur une installation neuve, c'est admin avec le mot de passe admin123, que vous devriez changer avant que quoi que ce soit ne soit accessible depuis l'extérieur.

« J'obtiens une redirection, pas un flux. » Le chemin de la base de données n'est pas configuré. Voir plus haut.

« Ça marchait hier et pas aujourd'hui. » L'adresse IP du serveur a presque toujours changé. Réservez-la dans votre routeur.

« Le catalogue est vide. » calibre-web pointe vers une bibliothèque Calibre sans livres, ou vers un dossier qui n'est pas une bibliothèque Calibre. L'interface web paraîtra tout aussi vide ; vérifiez-la en premier, car le flux ne reflète que ce que calibre-web lui-même peut voir.

« Certains livres ne se téléchargent pas. » calibre-web sert les formats présents dans votre bibliothèque Calibre. Si un livre n'existe qu'en AZW3 ou MOBI, convertissez-le en EPUB dans Calibre sur ordinateur et le format converti apparaîtra dans le flux.

Où cela se situe parmi les autres options

Si vos livres sont dans Calibre et que vous les voulez sur un iPhone, il existe trois voies, et elles sont vraiment différentes :

• calibre-web, cette page : une interface web qui fonctionne sans que l'application de bureau Calibre soit ouverte, avec des comptes utilisateurs et un flux OPDS à :8083/opds.
• Le Calibre Content Server, à :8080/opds, intégré à Calibre lui-même et qui nécessite que l'application de bureau ou calibre-server soit en cours d'exécution. Il n'a aucune authentification tant que vous ne l'activez pas. Voir le guide du Content Server.
• Un dossier cloud ou une copie de fichiers directe, qui ne nécessite aucun serveur. Voir comment synchroniser Calibre avec iPhone et iPad.

justRead se connecte aux trois, ainsi qu'à Komga, Kavita, COPS et tout autre serveur OPDS, avec un filtrage et une pagination par serveur pour qu'une grande bibliothèque reste utilisable sur un téléphone. La page lecteur OPDS recense l'URL et la méthode d'authentification vérifiées pour chaque serveur que nous avons testé, et la liste des catalogues OPDS gratuits couvre les catalogues publics plutôt que votre propre bibliothèque.

Téléchargez justRead sur l'App Store et connectez-le à votre serveur calibre-web.