====== Calibre Web ======

Aplicación web para navegar, leer y descargar libros electrónicos almacenados en una base de datos de [[informatica:software:calibre|Calibre]].

  * [[https://github.com/janeczku/calibre-web|Repositorio oficial]]

{{ https://raw.githubusercontent.com/wiki/janeczku/calibre-web/images/main_screen.png |}}

La base de datos de calibre es un fichero llamado ''metadata.db'' y es necesario que exista para poder utilizar **Calibre Web**. Se puede partir de una de prueba como [[https://github.com/kovidgoyal/calibre/blob/master/src/calibre/db/tests/metadata.db|esta]] o [[https://github.com/janeczku/calibre-web/raw/master/library/metadata.db|esta otra]].

===== Instalación =====

==== Docker ====

Creamos un par de carpetas:

  * ''config'': donde calibre-web almacena la configuración y base de datos interna.
  * ''books'': dónde se encuentra la base de datos de Calibre.

Useremos la [[https://hub.docker.com/r/linuxserver/calibre-web|imagen]] de LinuxServer.

<code yaml>
version: "2.1"
services:
  calibre-web:
    image: ghcr.io/linuxserver/calibre-web
    container_name: calibre-web
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Madrid
      # Si queremos poder hacer conversión de formatos de libros
      # - DOCKER_MODS=linuxserver/calibre-web:calibre
    volumes:
      - ./config:/config
      - ./books:/books
    ports:
      - 80:8083
    restart: unless-stopped
</code>

Por defecto, estas son las credenciales:

  * Usuario: ''admin''
  * Contraseña: ''admin123''

La primera vez que accedamos, en la configuración de la base de datos, indicaremos ''/books'' donde pregunta //Location of Calibre Database//. En ese fichero debe estar previamente el fichero ''metadata.db''.
===== Subir libros =====

Para poder añadir libros a la biblioteca, hay que habilitar la opción de subidas desde el menú de administración: Admin -> Editar la configuración básica -> Configuración de características -> **Permitir subidas**.

===== Descargar libros =====


===== Configuración =====

==== Cambiar tema visual ====

//Admin// -> //Editar la configuración de la interfaz de usuario// -> //Configuración de la interfaz de usuario// -> **Tema**. Por defecto, hay dos opciones: **Tema estándar** y **caliBlur! Tema oscuro**.

===== OPDS =====

OPDS son las siglas en inglés de sistema de distribución para publicaciones abiertas (//Open Publication Distribution System//) y se trata de una especificación técnica para difundir publicaciones digitales.

Calibre web expone OPDS para que cualquier cliente que lo implemente pueda conectarse al catálogo y leer los libros (como por ejemplo [[informatica:sistemas_operativos:android:aplicaciones:librera|Librera]], para Android).

Desde el cliente que queramos, tendremos que especificar la ruta a Calibre web de algunas de las siguientes 2 maneras:

  * ''http://instalacion.calibre.web/opds?auth=usuario:contraseña''
  * ''http://usuario:contraseña@instalacion.calibre.web/opds''

===== Recursos =====

  * [[https://hub.docker.com/r/linuxserver/calibre-web|A Calibre-Web container, brought to you by LinuxServer.io]]