smart-covers
Plugin para Jellyfin que extrae portadas de PDF, EPUB y audiolibros. Actúa como red de seguridad ante fallos de proveedores nativos, con búsqueda online en Open Library y Google Books. Soporta .NET 9.0 y no requiere herramientas externas gracias a bibliotecas integradas.
Ficha actualizada 22 sept 2026, 15:40 · upstream 22 sept 2026, 9:22 · release v7.4.0.0
Qué es smart-covers
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
SmartCovers es un complemento para Jellyfin diseñado para la extracción de imágenes de portada en bibliotecas de libros, cómics, revistas y audiolibros. Funciona como una red de seguridad junto a los proveedores nativos: cuando estos fallan o se bloquean con artefactos incrustados mal etiquetados, SmartCovers interviene para recuperar la imagen correspondiente.
El plugin soporta múltiples formatos mediante métodos específicos: renderizado de PDFs usando PDFium integrado, búsqueda jerárquica en archivos EPUB y extracción de arte incrustado en audio (MP3, M4A, FLAC) mediante ffmpeg con detección de magic bytes. Para cómics CBZ/CBR, detecta el contenido real ignorando extensiones incorrectas y selecciona la primera página natural o una entrada explícita.
Incluye un mecanismo de fallback online que consulta Open Library y Google Books cuando los métodos locales no encuentran resultados. Además, gestiona carpetas de audiolibros identificando el nombre del libro por la estructura de directorios y ofrece una tarea programada para refrescar portadas faltantes sin alterar metadatos existentes.
- Recuperar portadas de PDFs sin metadatos externos mediante renderizado local.
- Extraer artefactos incrustados en archivos de audio ignorando errores de codificación ID3.
- Leer cómics CBZ/CBR detectando contenido real frente a extensiones falsas.
- Buscar portadas online automáticamente en Open Library y Google Books como último recurso.
- Identificar audiolibros en carpetas usando el nombre del directorio como título principal.
- Actualizar programáticamente portadas faltantes mediante tarea planificada diaria.
- No requiere herramientas externas; PDFium y SharpCompress están integrados en el binario.
- Soporte nativo para múltiples arquitecturas (Linux x64/arm64, macOS, Windows).
- Detección robusta de formatos de audio mediante inspección de magic bytes.
- Búsqueda online sin necesidad de claves API ni configuración compleja.
- Integración directa en el ecosistema Jellyfin como plugin oficial.
- Manejo automático de archivos mal etiquetados o con extensiones incorrectas.
- Requiere Jellyfin 10.11 o superior para la compatibilidad del framework.
- El renderizado de PDFs puede ser lento si se utiliza un DPI muy alto.
- La búsqueda online puede fallar si el título es ambiguo o demasiado genérico.
- Se recomienda el plugin Bookshelf v13+ para una gestión óptima de EPUBs.
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.
Instalar desde repositorio oficial en Dashboard > Plugins > Repositories. Alternativamente, extraer manualmente el zip a <jellyfin-config>/plugins/ y reiniciar Jellyfin. Para desarrollo, compilar con dotnet publish y fusionar SharpCompress en SmartCovers.dll para evitar advertencias de compatibilidad.
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.