BookinglyTech News
Software

Issued: servidor autoalojado para bibliotecas de cómics con OPDS

Herramienta open source en Python para gestionar colecciones de CBZ/CBR sin forzar reestructuraciones ni dependencias pesadas.

2 min de lecturar/selfhosted0 vistas

Un desarrollador ha publicado Issued, un servidor de biblioteca de cómics autoalojado que prioriza la ligereza y el respeto estricto por la estructura de carpetas del usuario. La herramienta está escrita en Python y permite gestionar archivos CBZ y CBR mediante el protocolo OPDS y un lector web integrado, eliminando la necesidad de aplicaciones de escritorio pesadas.

El proyecto nace de la frustración del autor con soluciones existentes que imponían estructuras de organización específicas o dependían de stacks como Java o .NET, considerados innecesarios para esta función. Issued utiliza FastAPI para el backend, SQLite con migraciones Alembic para la base de datos y Jinja2 con JavaScript nativo (estilizado con Tailwind) para el frontend. Para el procesamiento de archivos, recurre a rarfile para extraer contenido CBR y Pillow para generar miniaturas, empleando SQLModel como ORM.

La principal ventaja operativa es la ausencia de reorganización forzada: el sistema escanea las carpetas existentes y las sirve tal cual están. Incluye monitoreo en tiempo real mediante watchdog para detectar nuevos archivos automáticamente. El acceso dual permite sincronizar el progreso de lectura desde aplicaciones móviles compatibles con OPDS, como Panels o Chunky, o directamente a través del navegador web. El sistema parsea metadatos de ComicInfo.xml, permitiendo editarlos desde la interfaz web, y mantiene registro de series en curso, indicando números leídos y posibles huecos.

La distribución está pensada para entornos de autoalojamiento típicos: ofrece imágenes Docker multi-arquitectura (amd64 y arm64) alojadas en GHCR, además de binaries compilados con PyInstaller para Mac, Linux y Windows. El código está disponible en GitHub bajo licencia MIT, lo que facilita su integración en ecosistemas heterogéneos sin restricciones de uso comercial.

Para los administradores de sistemas que ya gestionan bibliotecas multimedia autoalojadas, Issued se posiciona como una alternativa minimalista frente a servidores más complejos. Su stack técnico, basado en Python y SQLite, simplifica el despliegue y el mantenimiento, especialmente en contenedores con recursos limitados. La disponibilidad de migraciones de base de datos mediante Alembic sugiere una intención de mantener estabilidad a largo plazo en la estructura de datos, aunque al tratarse de un proyecto individual, la comunidad deberá validar su madurez ante escalas de usuario superiores.