Repositorio para una mini-aplicación para consultar localmente el catálogo de EPL
- Release 1.17.30: https://github.com/Verdoso/epl_librarian/releases/tag/Release_Tag_v1.17.30
- Release 1.17.29: https://github.com/Verdoso/epl_librarian/releases/tag/Release_Tag_v1.17.29
- Release 1.17.21: https://github.com/Verdoso/epl_librarian/releases/tag/Release_Tag_v1.17.21
Esta versión sirve para cualquier S.O. y es la que hay que usar, de momento, en Linux o MacOS.
- Tener instalado Java 17 o superior (Por ejemplo, del proyecto abierto y gratuito Temurin https://adoptium.net/es/temurin/releases)
- Tener configurado el comando java en el path (lo podemos comprobar ejecutando java -version en un terminal)
Descargar el fichero epl_librarian-*.*.*.zip, descomprimirlo en un directorio sin espacios y ejecutar el fichero .cmd o .sh dependiendo de si estamos en Windows o *nix. También podemos ejecutarlo directamente en un terminal con el comando java -Xms1g -Xmx1g -jar epl_librarian-version.jar. Ojo que si hacemos doble-click en el .jar Windows es posible que nos arranque la aplicación en segundo plano y para matarla tengamos que usar el botón "Cerrar" de la aplicación (arriba a la derecha) o usar el "Administrador de tareas" de Windows.
Esta versión se puede ejecutar en Windows 10 sin que haga falta tener Java instalado
- Windows 10
Descargar el fichero epl_librarian-*.*.*-Windows.zip, descomprimirlo en un directorio sin espacios y ejecutar el fichero .exe que contiene. Seguramente al ejecutar por primera vez una versión, Windows nos dirá que es un fichero sin editor conocido y tengamos que darle permisos para ejecutarlo y para acceder a la red. Le damos permisos y ya está, no tendremos que volver a dárselos.
En cualquiera de las versiones, al acabar de preparar el catalogo (aparece en el log el mensaje EPL Librarian inicializado), debería abrirse automáticamente una ventana del navegador apuntando a la direccion http://localhost:7070/librarian/, si no es así tendremos que escribirla nosotros en un navegador para acceder.
Hay que tener en cuenta que:
- El programa almacena los ficheros del catalogo en el directorio temporal del usuario
- Si el catalogo almacenado tienes mas de 24h, intentará descargarse una versión nueva desde ePubLlibre
- En caso de no poder descargarse una versión nueva, intentará cargar un fichero que se haya descargado manualmente y colocado en el directorio temporal.
A partir de la versión 1.17.30, EPL Librarian consulta este mismo README en GitHub para ver si existe una nueva versión y, si es el caso, muestra un un botón de aviso, al lado del botón de cerrar, que enlaza con la página desde donde se puede uno descargar la nueva versión. Esta funcionalidad es meramente informativa y lo único que se hace es consultar la página README como si fuese un navegador cualquiera, pero en caso de no querer que el programa acceda a la página de GitHub, se puede deshabilitar esta opción añadiendo la propiedad skip_version_check a true a nuestro fichero de preferencias.
- En caso de que no queramos que intente descargarse una versión nueva de la biblioteca de ePubLlibre, podemos añadir al arrancar la propiedad
-Ddescarga_epl=false. En ese caso intentará usar el backup o el fichero descargado manualmente, pero en ningún caso intentará acceder a ePubLlibre. - Si queremos incrementar el número de horas antes de descargar una una versión nueva de la biblioteca de ePubLlibre (por defecto 24h) podemos incrementarlo, por ejemplo a 48h, añadiendo la propiedad
-Dantiguedad_maxima=48al arranque. - Si queremos que directamente ignore la antiguedad del backup y si tiene uno lo use, podemos hacerlo añadiendo al arranque la propiedad
-Dactualizacion_automatica=false. Si no hay backup intentará la descarga de ePubLlibre, pero si lo hay no la intentará. - Modo 'superportable'. Si queremos que el programa no cree ningún fichero fuera del directorio del programa, podemos pasarle el flag
-Dsuperportable=true. En ese caso, el fichero de preferencias y los ficheros temporales/backup de las descargas se almacenaran el el mismo directorio desde donde se lanza el programa, en los directorios .librariany y tmp. Ojo Eso quiere decir que al cambiar de versión del programa, tendremos que copiar las preferencias (directorio .librarian) y los ficheros temporales (directorio tmp) para no perder esos datos.
Si tenemos instalado el software para gestión de libros Calibre en el mismo ordenador donde se ejecuta EPL Librarian y queremos que nos compruebe los libros que tenemos, podemos hacerlo especificándole donde se encuentra la biblioteca de Calibre en nuestro ordenador, en las preferencias, de la siguiente forma:
Con el EPL Librarian apagado, editamos el fichero $HOME/.librarian/preferences.properties ( EPL Librarian nos indica la localización exacta en la consola al arrancar ) y añadimos una propiedad calibre_home indicándonle el camino a la biblioteca en formato "properties de Java"(el directorio donde Calibre guarda su fichero metadata.db).
Por ejemplo, si Calibre guarda los libros en un directorio 'D:\Libros' podríamos añadir a preferences.properties la siguiente linea
calibre_home=D\:/Libros
Es necesario añadir una barra inversa '\' antes del caracter ':' y cambiar las barras '\' del path por barras '/' para evitar que haya problemas, ya que esos caracteres son especiales en los ficheros de properties.
Al arrancar EPL Librarian nos indicará que integración con Calibre está habilitada, tardará un poco más en arrancar y en la biblioteca aparecera unas nuevas columnas que nos indicarán, para cada libro, si se ha encontrado dicho libre en nuestra biblioteca Calibre y si ese libro lo "descartamos". También nos aparecerá un filtro nuevo para ocultar los libros que ya tengamos en nuestra biblioteca de Calibre y/o los que hayamos descartado. Para descartar o habilitar de nuevo un libro basta con hacer click en el simbolo del ojo en la fila correspondiente. De esta forma es muy sencillo saber si tenemos todos los libros que nos interesan de nuestros autores favoritos, simplemente marcando los filtros de "autores favoritos", "idiomas favoritos" y "ocultar libros que tenemos y los descartados".
La comprobación mira el título exacto del libro y sus autores, por lo que puede ser que no encuentre algún libro que no tenga exactamente el mismo título (p.e. 'El Camel Club' vs 'Camel Club') o que tenga alguna errata en el nombre (p.e. 'James S.A. Corey' vs 'James S. A. Corey'). Se ha optado por quedarse corto y decir que hay libros que no tenemos, por pequeñas diferencias en los datos, que posibilitar los errores al reves y dar por hecho que tenemos ciertos libros por ser demasiado generosos en las comprobaciones.
Si queremos que el programa actualice la base de datos de Calibre con los identificadores de los libros de EPubLibre, podemos hacerlo configurando la propiedad calibre_update a true. De esta forma, cuando encuentre un libro en Calibre que se encuentre en la lista de libros de EPubLibre pero no tenga bien configurado su epl_id, actualizará la BDD del Calibre para ponérselo. Los libros que tienen configurado el epl_id correctamente se reconocen mucho más rápido durante la sincronización.
El programa sincroniza automáticamente los datos de Calibre al arrancar, pero también es posible actualizar los datos mientras el programa está en marcha haciendo click con el ratón sobre el botón de "Integración con Calibre":
Esta funcionalidad es útil cuando estamos añadiendo al Calibre libros que nos faltán y queremos actualizar los resultados del filtro "Ocultar los que tengo/descartados".
El programa ofrece varios listados
En este listado se muestran los datos básicos de los libros y se puede filtrar y ordenar por distintos criterios (título, colección, autor, idioma, género). En este listado se puede escoger una fecha (indicada por "Considerar novedades libros posteriores a") para que únicamente se muestres los libros disponibles en ePubLlibre a partir de esa fecha. Para que el filtro se lleve a cabo hay que activar el interruptor "Solo novedades". Si le damos al botón de guardar almacenará la fecha y la recordará para posteriores arranques. Por otro lado, si hemos marcado como favoritos algunos idiomas, generos o autores, podemos activar los filtros para que solo se muestren los libros que cumplan esos criterios. Si tenemos activa la integración con Calibre también tendremos el filtro de ocultar los libros que ya tenemos o que hemos descartado, y veremos las columnas correspondientes a esos valores.
Podemos ampliar la información de cada libro, haciendo clic en la marca al lado del título, y así podremos ver más detalles del libro, como la sinopsis, la portada, un enlace a la página del libro en EPL y los enlaces magnet ofrecidos por EPL.
En esta sección podemos consultar los autores de los libros del catalogo, podemos marcarlos como favoritos y podemos seleccionar uno en concreto (doblec clic) para añadirlo como filtro en la página principal.
En esta sección podemos consultar los géneros bajo los que están clasificados los libros del catalogo, podemos marcarlos como favoritos y podemos seleccionar uno en concreto (doblec clic) para añadirlo como filtro en la página principal.
En esta sección podemos consultar los idiomas de los libros del catalogo, podemos marcarlos como favoritos y podemos seleccionar uno en concreto (doblec clic) para añadirlo como filtro en la página principal. Funciona exactamente igual a los listados anteriores de autores y géneros.
En esta sección podemos encontrar unos gráficos sobre la distribución de autores, géneros e idiomas. En el caso de autores y géneros solo se muestran los más populares, dado el volumen de datos. El gráfico de doughnut de idiomas es interactivo y podemos habilitar/deshabilitar idiomas para poder ver el resto de idiomas más claramente.
En caso de tener la integración con Calibre habilitada, podremos optar por ver los mismos gráficos pero solo de los libros de EPL que tenemos en nuestra libreria de Calibre a través del check (Mi biblioteca Calibre).
A partir de la version 0.0.41, en el listado de libros se puede saltar directamente a una página introduciendo el número deseado en el campo al lado de los botones de "siguiente" y "anterior" de la paginación.
Se han añadido opciones para poder minimizar la parte de los menús de la interfaz y recogerlo todo y dejar el máximo espacio a la tabla de consulta de libros.
