OPDS de calibre-web en iPhone e iPad: la URL exacta y el inicio de sesión

Respuesta rápida: el feed OPDS de calibre-web está en http://<tu-servidor>:8083/opds. Pide el mismo usuario y contraseña que usas para la interfaz web de calibre-web, mediante autenticación HTTP Basic, y tu sesión del navegador no se traslada, así que los vuelves a escribir en la app de lectura. Calibre-Web-Automated usa exactamente la misma dirección y el mismo inicio de sesión. Añade esa URL como catálogo OPDS personalizado en un lector en tu iPhone o iPad y tu biblioteca de Calibre aparece ahí.

Todo lo que sigue se comprobó el 24 de agosto de 2026 contra calibre-web 0.6.27 y Calibre-Web-Automated v4.0.6, ambos ejecutados desde sus imágenes oficiales contra una biblioteca Calibre real, en lugar de copiado de la documentación.

La dirección, y las tres cosas que fallan

1. La sesión web no autentica el feed

Este es el detalle que atrapa a quienes tienen calibre-web abierto en una pestaña del navegador y suponen que el lector entrará de la misma forma. No es así. El feed usa autenticación Basic, completamente separada de la cookie que guarda tu navegador, y devuelve 401 con una cabecera WWW-Authenticate hasta que proporcionas un usuario y una contraseña.

Eso es una buena noticia para la configuración: cualquier lector OPDS compatible con usuario y contraseña se conectará. En justRead, añades el servidor una vez con la URL, el usuario y la contraseña, y queda recordado.

2. Una redirección en lugar de un feed significa que el servidor no está configurado

Antes de que calibre-web apunte a una base de datos de Calibre, cada ruta del servidor, incluida /opds, devuelve un 302 hacia /admin/dbconfig. Si tu lector muestra algo raro en lugar de pedir una contraseña, abre http://<tu-servidor>:8083/ en un navegador. Si te envía a una página de configuración de base de datos, la URL nunca fue el problema: un administrador tiene que fijar antes la ruta de la biblioteca Calibre.

Calibre-Web-Automated no tiene este problema. Llega con una biblioteca ya configurada y sirve OPDS desde el primer arranque, algo que conviene saber si estás eligiendo entre los dos y quieres tener el teléfono funcionando hoy mismo.

3. Puerto 8083, no 8080

8080 es el Calibre Content Server, que es un programa distinto de calibre-web y que cubrimos en la guía del Calibre Content Server. Los dos se confunden constantemente, y mezclar sus puertos produce un fallo de conexión que parece un problema de red.

También se diferencian en la autenticación de un modo que importa aquí: el Calibre Content Server no tiene ninguna autenticación por defecto, mientras que calibre-web siempre la exige. Si tu lector se conectó a un servidor con aspecto de Calibre sin pedir contraseña, era el Content Server.

Lo que obtienes una vez conectado

La raíz OPDS de calibre-web sirve quince secciones. Las quince estaban presentes en ambas versiones probadas:

Libros por orden alfabético, Libros populares, Libros mejor valorados, Libros añadidos recientemente, Libros aleatorios, Libros leídos, Libros no leídos, Autores, Editoriales, Categorías, Series, Idiomas, Valoraciones, Formatos de archivo, Estanterías.

Esa es la misma estructura que la interfaz web, y ahí está la clave: los metadatos que organizaste en Calibre, las series, las valoraciones, las estanterías personalizadas, pasan al feed en lugar de aplanarse en una sola lista larga.

La búsqueda aparece dos veces, como una plantilla /opds/search/{searchTerms} y como un descriptor OpenSearch en /opds/osd, así que un lector compatible con búsqueda en el servidor puede consultar al servidor en lugar de descargarlo todo y buscar localmente. Esa diferencia importa a partir de unos pocos miles de libros.

calibre-web frente a Calibre-Web-Automated: qué cambia en realidad

Calibre-Web-Automated es un fork en desarrollo activo que añade ingesta automática, conversión y gestión de metadatos sobre calibre-web. La pregunta obvia para un teléfono es si su feed OPDS es diferente.

Ejecutamos ambos en paralelo y comparamos los feeds. La respuesta es: misma URL, misma autenticación, y exactamente una sección extra.

Calibre-Web Automated      (título del feed)
Calibre-Web

Magic Shelves              (presente solo en CWA)

Todo lo demás es idéntico: /opds, HTTP Basic, y las mismas quince secciones en el mismo orden. Lo que es cierto del OPDS de calibre-web es cierto del de CWA.

La única diferencia práctica no está en el feed en absoluto. CWA viene con una biblioteca configurada y responde desde el primer arranque; el calibre-web normal redirige todo a /admin/dbconfig hasta que alguien fija la ruta de la base de datos.

Conectarlo desde un iPhone o un iPad

1. Encuentra la dirección de tu servidor en la red. Una IP local como 192.168.1.20, o un nombre de host si tienes uno. Resérvala en las reservas DHCP de tu router, de lo contrario la dirección cambia y el catálogo deja de funcionar sin motivo visible.
2. Confirma el feed en un navegador primero. Abre http://<tu-servidor>:8083/opds. Debería pedirte un usuario y una contraseña, y luego ver un muro de XML. Si te redirige a una página de configuración, vuelve al punto 2 de arriba.
3. Añádelo en tu lector como catálogo OPDS personalizado: la URL, tu usuario de calibre-web, tu contraseña de calibre-web.
4. Explora y descarga. OPDS entrega archivos en lugar de transmitir páginas, así que un libro se descarga al dispositivo y se lee ahí. Eso también significa que sigue funcionando cuando estás lejos del servidor, y que tu posición de lectura se queda en el teléfono en lugar de sincronizarse de vuelta a calibre-web.

Para la versión general de estos pasos en cualquier servidor, consulta cómo configurar OPDS en iPhone y iPad.

Acceder desde fuera de casa

Dentro de tu propia red, el HTTP simple funciona bien y es lo más sencillo que hay.

Desde fuera, no te limites a reenviar el puerto 8083. Dos enfoques merecen el esfuerzo:

• Un proxy inverso con un certificado real. Caddy o nginx delante de calibre-web, con un certificado de Let's Encrypt, te da HTTPS en el que iOS confía sin ninguna configuración en el dispositivo.
• Una VPN o una red mesh de vuelta a tu propia LAN, tras lo cual la dirección local funciona sin cambios desde cualquier sitio.

Lo que no funciona sin más es un certificado autofirmado. iOS lo rechaza a menos que el certificado esté instalado en el dispositivo y se confíe en él explícitamente en Ajustes, General, Información, Ajustes de confianza de certificados. Hasta entonces la conexión simplemente falla, y el fallo parece exactamente que el servidor está caído, no que haya un problema de certificado.

Fallos habituales, en el orden en que suelen aparecer

"Pide una contraseña y rechaza la correcta." calibre-web tiene sus propias cuentas de usuario, separadas de cualquier inicio de sesión del sistema operativo. Usa la cuenta con la que entras en la interfaz web de calibre-web. El valor predeterminado en una instalación nueva es admin con la contraseña admin123, que deberías cambiar antes de que nada sea accesible desde fuera.

"Recibo una redirección, no un feed." La ruta de la base de datos no está configurada. Ver más arriba.

"Funcionaba ayer y hoy no." Casi siempre la IP del servidor ha cambiado. Resérvala en tu router.

"El catálogo está vacío." calibre-web apunta a una biblioteca Calibre sin libros, o a un directorio que no es una biblioteca Calibre. La interfaz web se verá igual de vacía; compruébalo ahí primero, porque el feed solo refleja lo que el propio calibre-web puede ver.

"Algunos libros no se descargan." calibre-web sirve los formatos presentes en tu biblioteca Calibre. Si un libro existe solo como AZW3 o MOBI, conviértelo a EPUB en Calibre en el escritorio y el formato convertido aparecerá en el feed.

Dónde encaja esto entre las demás opciones

Si tus libros están en Calibre y quieres tenerlos en un iPhone, hay tres rutas y son genuinamente distintas:

• calibre-web, esta página: un front end web que funciona sin tener abierta la app de escritorio de Calibre, con cuentas de usuario y un feed OPDS en :8083/opds.
• El Calibre Content Server, en :8080/opds, que viene integrado en el propio Calibre y necesita la app de escritorio o calibre-server en ejecución. No tiene autenticación hasta que la activas. Consulta la guía del Content Server.
• Una carpeta en la nube o una copia directa de archivos, que no necesita ningún servidor. Consulta cómo sincronizar Calibre con iPhone y iPad.

justRead se conecta a los tres, y a Komga, Kavita, COPS y cualquier otro servidor OPDS, con filtrado y paginación por servidor para que una biblioteca grande siga siendo manejable en un teléfono. La página del lector OPDS recoge la URL y el método de autenticación verificados de cada servidor que hemos probado, y la lista de catálogos OPDS gratuitos cubre catálogos públicos en lugar de tu propia biblioteca.

Descarga justRead en la App Store y apúntalo a tu servidor calibre-web.