Repolode
Enviar
BookHeaven

BookHeaven/BookHeaven.Server

Servidor web autohospedado para gestionar tu biblioteca de ebooks, con OPDS, sincronización con KOReader y una API para la app Android BookHeaven Reader.

Alternativa open source a:Calibre Web

Ver en GitHubSitio web
Estrellas
201
Forks
4
Issues abiertos
2
Último commit
anteayer

¿Qué es?

BookHeaven Server es una aplicación web para organizar y leer una biblioteca de ebooks en tu propio equipo. Agrupa los libros por autor, serie y colección, admite etiquetas y lee los metadatos directamente de cada archivo. Los cambios en los títulos, autores o portadas se guardan en el propio archivo, y también se pueden obtener portadas y metadatos de Internet.

El servidor registra el progreso de lectura de cada perfil, incluidas las fechas de inicio, de última lectura y de finalización, el porcentaje leído y el tiempo transcurrido. El progreso también se puede ajustar manualmente. Cada perfil mantiene un historial de lectura independiente para cada usuario. Se pueden subir fuentes personalizadas para que los dispositivos puedan descargarlas.

Para los clientes, el servidor ofrece un feed OPDS en /opds/v1, permite sincronizar con KOReader y proporciona una API propia que utiliza la app Android BookHeaven Reader, que puede detectar automáticamente el servidor en la red local. Se implementa con Docker o Podman, mediante un volumen para los datos y una carpeta de importación opcional.

Funciones clave

  • 01Organizar libros por autor, serie, colección y etiquetas
  • 02Editar metadatos y portadas, y guardar los cambios en el propio archivo del ebook
  • 03Obtener portadas y metadatos de Internet
  • 04Registrar el progreso de lectura por perfil y ajustarlo manualmente
  • 05Feed OPDS en /opds/v1 y compatibilidad con la sincronización de KOReader
  • 06Detección automática del servidor para la app Android BookHeaven Reader

Casos de uso

  • Alojar una biblioteca personal de ebooks en un servidor doméstico y leerlos en distintos dispositivos
  • Ofrecer un catálogo OPDS a apps de lectura compatibles
  • Sincronizar el progreso de lectura entre KOReader y un servidor central
  • Gestionar fuentes personalizadas para dispositivos que leen tus libros

Inicio rápido

  1. 1

    Descarga la imagen del contenedor desde GitHub Container Registry

    docker pull ghcr.io/bookheaven/bookheaven-server:latest
  2. 2

    Inicia el servidor con Docker run y asigna el puerto de la interfaz web y la carpeta de datos

    docker run -d --name bookheaven --user 1000:1000 -p 8080:8080 -p 27007:27007/udp -v $PWD/data:/app/data -v $PWD/import:/app/import -e SERVER_URL=https://bookheaven.yourdomain.tld ghcr.io/bookheaven/bookheaven-server:latest
  3. 3

    Abre la interfaz web en el navegador en el puerto 8080

Antes de usarlo

  • No se recomienda guardar la carpeta de datos en una unidad de red porque se utiliza SQLite.

En colecciones

Apps autoalojadas

Temas

#ebook#self-hosted#ebook-library#opds#docker#koreader#bookheaven#books

Preguntas frecuentes

¿Qué es BookHeaven.Server?
Servidor web autohospedado para gestionar tu biblioteca de ebooks, con OPDS, sincronización con KOReader y una API para la app Android BookHeaven Reader. BookHeaven Server es una aplicación web para organizar y leer una biblioteca de ebooks en tu propio equipo. Agrupa los libros por autor, serie y colección, admite etiquetas y lee los metadatos directamente de cada archivo. Los cambios en los títulos, autores o portadas se guardan en el propio archivo, y también se pueden obtener portadas y metadatos de Internet.
¿BookHeaven.Server es gratuito? ¿Qué licencia tiene?
BookHeaven.Server es open source bajo la licencia GPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿BookHeaven.Server sigue mantenido?
Mantenimiento activo. El último commit de BookHeaven.Server fue el 5 nov 2026.
¿Para qué puedo usar BookHeaven.Server?
Alojar una biblioteca personal de ebooks en un servidor doméstico y leerlos en distintos dispositivos Ofrecer un catálogo OPDS a apps de lectura compatibles Sincronizar el progreso de lectura entre KOReader y un servidor central Gestionar fuentes personalizadas para dispositivos que leen tus libros
¿Cómo se instala BookHeaven.Server?
Descarga la imagen del contenedor desde GitHub Container Registry: docker pull ghcr.io/bookheaven/bookheaven-server:latest Inicia el servidor con Docker run y asigna el puerto de la interfaz web y la carpeta de datos: docker run -d --name bookheaven --user 1000:1000 -p 8080:8080 -p 27007:27007/udp -v $PWD/data:/app/data -v $PWD/import:/app/import -e SERVER_URL=https://bookheaven.yourdomain.tld ghcr.io/bookheaven/bookheaven-server:latest Abre la interfaz web en el navegador en el puerto 8080
¿Dónde consigo BookHeaven.Server?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/BookHeaven/BookHeaven.Server

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados