Issued Comic | Comic Library | Docker

Issued Comic: Biblioteca de cómics rápida y minimalista autohospedada en Docker

Servidor de cómics ultraligero. CBZ, CBR, PDF. Lector web + OPDS. Escaneo automático. Seguimiento de series. Thumbnails. Python puro. Perfecto para homelabs y NAS.

¿Qué es Issued Comic?

Issued Comic es un servidor de biblioteca de cómics minimalista, rápido y autohospedado diseñado para leer y gestionar tu colección de cómics desde cualquier dispositivo. A diferencia de herramientas complejas como Komga o Mylar, Issued es ultraligero, fácil de configurar, y se enfoca en lo esencial: servir tus cómics rápidamente.

Características: Lee CBZ, CBR y PDF. Servidor OPDS para apps de lectura (Panels, Chunky). Lector web moderno. Escaneo automático de carpetas. Seguimiento de series en progreso. Thumbnails de portadas. API simple. Escrito en Python, incluyendo unrar para CBR. Perfecto para Raspberry Pi, NAS, VPS pequeños.

Filosofía minimalista: Issued hace lo esencial bien y rápido. No tiene 500 features. Tiene los que necesitas: leer cómics, organizar, compartir vía OPDS. Eso es todo.

Características principales

Lector web moderno

Lee en navegador. Responsive. Funciona en móvil sin app.

OPDS API

Compatible con apps Panels, Chunky, y lectores OPDS.

CBZ, CBR, PDF

Soporta los formatos comunes de cómics.

Escaneo automático

Monitorea carpeta, detecta nuevos cómics automáticamente.

Series en progreso

Marca series activas, ve totales, detecta gaps.

Thumbnails

Genera previsualizaciones automáticas de portadas.

Continuar lectura

Recuerda dónde estabas en cada cómic.

Ultra ligero

Python puro, unrar incluido. Funciona en cualquier hardware.

Requisitos del sistema

Docker instalado
256 MB - 512 MB RAM (muy ligero)
Espacio disco según colección de cómics
Puerto 8181 (configurable)
Python 3.x (incluido en imagen Docker)
unrar (incluido en imagen Docker para CBR)

Ideal para: Raspberry Pi, NAS Synology/QNAP, VPS barato, homelabs con recursos limitados.

Instalación con Docker Compose

Opción 1: Setup mínimo

mkdir issued && cd issued cat > docker-compose.yml << 'EOF' version: '3.8' services: issued: image: ghcr.io/metalogico/issued:latest container_name: issued restart: unless-stopped ports: - "8181:8181" volumes: - ./data:/app/data - /home/user/Comics:/comics:ro # Cambia esta ruta EOF docker compose up -d

Opción 2: Personalizado

version: '3.8' services: issued: image: ghcr.io/metalogico/issued:latest container_name: issued restart: unless-stopped ports: - "8181:8181" volumes: - ./data:/app/data - /home/user/Comics:/comics:ro environment: - COMICS_DIR=/comics - DATA_DIR=/app/data

Rutas por SO

# Linux /home/user/Comics:/comics:ro # macOS /Users/john/Comics:/comics:ro # Windows C:/Comics:/comics:ro

Iniciar

docker compose up -d

Acceder

http://localhost:8181 (web) o http://localhost:8181/opds/ (OPDS)

Primeros pasos

1. Asegúrate de tener cómics en la carpeta

Coloca archivos .cbz, .cbr, .pdf en la carpeta especificada en docker-compose.yml

2. Acceder a la interfaz web

Abre http://localhost:8181
Verás biblioteca de cómics
Si no ves nada, click refresh icon para escanear

3. Leer un cómic

Click en cómic desde biblioteca
Se abre lector web con visor de páginas
Navega con flechas o click
Progreso se guarda automáticamente

4. Marcar serie como en progreso

Desde biblioteca, click en serie
Opción "Mark as ongoing"
Ahora ves totales y posibles gaps en la serie

5. Usar con app OPDS (móvil)

En app como Panels o Chunky: Add Server
URL: http://localhost:8181/opds/ (o tu IP/dominio)
Conecta, elige cómic, lee
Sin necesidad de descargar, lee directo del servidor

Casos de uso

Coleccionista de cómics: Organiza y accede a tu colección desde cualquier lugar
Manga/manwha en casa: Servidor personal para series que lees regularmente
Documentos PDF organizados: Técnicamente funciona con PDFs (comics, manuales)
Familia en red local: Comparte biblioteca con apps OPDS entre dispositivos
Raspberry Pi/NAS: Server ultraligero que no consume recursos
Lectura offline: Descarga vía OPDS para leer sin conexión

Escaneo automático y monitoreo

Escaneo inicial

Cuando inicia Issued, escanea automáticamente la carpeta /comics

Detectar nuevos cómics

Copia nuevos .cbz/.cbr a carpeta de cómics
Issued los detecta automáticamente (si monitoreo está activo)
O click refresh icon en web para forzar escaneo

Monitoreo de carpeta

Issued monitorea la carpeta y actualiza biblioteca cuando cambios detectados

Tip: Si agregaste cómics y no aparecen, haz click refresh en web. El escaneo es rápido.

HTTPS con Caddy

Caddyfile

comics.tudominio.com { reverse_proxy localhost:8181 }

Acceso remoto

https://comics.tudominio.com con HTTPS automático

OPDS remoto

https://comics.tudominio.com/opds/ para apps móviles

Gestión y mantenimiento

Ver logs

docker logs -f issued

Escanear manualmente

docker exec issued python -m issued scan

Reiniciar

docker compose restart issued

Actualizar a latest

docker compose pull docker compose up -d

Backup de base de datos

docker run --rm \ -v issued_data:/data \ -v $(pwd):/backup \ alpine tar czf /backup/issued-backup-$(date +%Y%m%d).tar.gz -C /data .

Ver espacio usado

du -sh /home/user/Comics

Cambiar permisos de carpeta

# Si hay problemas de permisos chmod 755 /home/user/Comics

Comparativa con alternativas

vs Komga

Issued gana: Más ligero, minimalista, setup rápido. Komga gana: Más features (colecciones, metadata avanzada, sincronización bilateral).

vs Mylar3

Issued gana: Lector web integrado, más simple. Mylar gana: Descarga automática, integración comics sources.

vs Codex

Issued gana: Más ligero, OPDS nativo. Codex gana: Más features (tags, búsqueda avanzada, multi-usuario).

Ideal para: Si solo necesitas leer y acceder rápidamente a tu colección sin configuración compleja, Issued es perfecto.

Referencias oficiales

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Cómo instalar Issued Comic en Docker - Biblioteca de cómics autohospedada en Docker