kumiho
Servidor web autoalojado ligero escrito en Go para gestionar y transmitir colecciones personales de cómics, libros electrónicos y audiolibros con soporte nativo para estructuras de carpetas recursivas.
Ficha actualizada 24 sept 2026, 19:42 · upstream 24 sept 2026, 19:25 · release v0.17.1
Qué es kumiho
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Kumiho es un servidor web multimedia diseñado específicamente para el consumo de cómics y libros digitales. Desarrollado originalmente por un usuario final, se distingue por su arquitectura en Go que elimina la sobrecarga de la JVM, ofreciendo tiempos de escaneo rápidos y un consumo de recursos optimizado para entornos con hardware limitado. La interfaz web responde adecuadamente en dispositivos móviles y tablets, permitiendo una experiencia de lectura fluida.
- Gestión personal de bibliotecas digitales de cómics (CBZ, EPUB, PDF) sin necesidad de servidores centralizados.
- Streaming de audiolibros con seguimiento de progreso, marcadores y reproducción automática de música de fondo.
- Organización flexible mediante estructuras de carpetas recursivas infinitas para colecciones complejas.
- Autoalojamiento en entornos domésticos o NAS con bajo consumo de CPU y memoria RAM.
- Escritura nativa en Go con compilación binaria, eliminando dependencias de runtime como Java o Node.js.
- Soporte para reproducción automática de música (BGM) cuando el nombre del archivo coincide con el volumen.
- Diseño responsive que adapta la interfaz a móviles y tablets sin requerir aplicaciones nativas.
- Escaneo recursivo de hojas (leaf discovery) que ignora carpetas intermedias vacías para encontrar series legibles.
- La variable de entorno PLUGIN_SECRET_KEY es obligatoria; sin ella, las credenciales de plugins no se pueden descifrar tras reinstalaciones.
- Actualizaciones recientes de Docker requieren re-pull de la imagen y recreación del contenedor por cambios en bases de imagen.
- Los datos de progreso y enlaces de metadatos no se transfieren automáticamente si se reconstruye la estructura de series.
- El usuario de ejecución cambió de root a appuser, lo que exige configurar PUID y PGID manualmente para evitar errores de permisos.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Recomendado usar Docker Compose con variables PUID=1000 y PGID=1000 ajustadas al usuario del host. Es obligatorio definir JWT_SECRET y PLUGIN_SECRET_KEY en el entorno antes de iniciar, ya que sin estas claves las credenciales almacenadas no se pueden recuperar tras una actualización. Tras actualizar la imagen, ejecutar docker-compose down/up para aplicar cambios en la base de imagen.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.