Repolode
nothing2obvi

nothing2obvi/pixelfin

Una aplicación web local para auditar las imágenes de Jellyfin, detectar las que faltan o tienen dimensiones incorrectas, editarlas y guardarlas en ZIP.

Estrellas
177
Forks
6
Issues abiertos
2
Último commit
hace 14 días

¿Qué es?

Pixelfin es una aplicación web local para revisar las imágenes de las bibliotecas de Jellyfin. Muestra una tabla resumen y galerías visuales de cada elemento multimedia, con tipos de imagen como Primary, Backdrop, Logo, ClearArt, Banner y Thumb. Señala las imágenes que faltan y las que están por debajo de una resolución mínima o superan un máximo opcional, para que puedas identificar las que necesitas reemplazar.

Puedes editar imágenes en Pixelfin con los proveedores configurados en tu servidor Jellyfin o subir archivos PNG, JPEG, WebP o GIF. También puedes exportar las imágenes a archivos ZIP y restaurarlas más adelante. Las restauraciones comienzan con una simulación que muestra puntuaciones de coincidencia y comparaciones en paralelo antes de subir nada a Jellyfin. Pixelfin también genera galerías HTML independientes y admite el despliegue con Docker.

Funciones clave

  • 01Señala las imágenes que faltan o están fuera del rango permitido para cada elemento multimedia y biblioteca.
  • 02Permite editar imágenes desde la aplicación, con opciones para buscarlas, subirlas, eliminarlas y reordenar los Backdrop.
  • 03Exporta imágenes a ZIP y las restaura con una revisión en modo de simulación y comparaciones en paralelo.
  • 04Genera galerías HTML independientes con una tabla resumen y enlaces a Jellyfin.
  • 05Admite bibliotecas de Series, Movies, Music, Music Videos y Collections.
  • 06Se ejecuta localmente con Python o mediante Docker en amd64 y arm64.

Casos de uso

  • Encontrar pósteres y Backdrop de baja resolución o que faltan en una biblioteca grande de Jellyfin.
  • Crear copias de seguridad de las imágenes antes de reconstruir o migrar un servidor Jellyfin.
  • Restaurar imágenes desde un ZIP después de migrar un servidor, empezando por una simulación.
  • Mantener imágenes coherentes en toda una biblioteca mediante una revisión visual.

Inicio rápido

  1. 1

    Instala las dependencias de Python desde requirements.txt

    pip install -r requirements.txt
  2. 2

    Inicia Pixelfin

    python app.py
  3. 3

    Abre la aplicación web en tu navegador

Antes de usarlo

  • No se especifica ninguna licencia, por lo que los derechos de uso no están claros.
  • No está diseñado pensando en la seguridad y solo debería ejecutarse en local o en una red privada de confianza.
  • Requiere un servidor Jellyfin en ejecución y una clave de API de Jellyfin.
  • El autor lo describe como una herramienta local, no como una aplicación de producción reforzada.

En colecciones

Temas

Preguntas frecuentes

¿Qué es pixelfin?
Una aplicación web local para auditar las imágenes de Jellyfin, detectar las que faltan o tienen dimensiones incorrectas, editarlas y guardarlas en ZIP. Pixelfin es una aplicación web local para revisar las imágenes de las bibliotecas de Jellyfin. Muestra una tabla resumen y galerías visuales de cada elemento multimedia, con tipos de imagen como Primary, Backdrop, Logo, ClearArt, Banner y Thumb. Señala las imágenes que faltan y las que están por debajo de una resolución mínima o superan un máximo opcional, para que puedas identificar las que necesitas reemplazar.
¿pixelfin es gratuito? ¿Qué licencia tiene?
pixelfin no declara ninguna licencia. Su código es público, pero sin licencia no tienes permiso explícito para reutilizarlo; consulta al autor antes de depender de él.
¿pixelfin sigue mantenido?
Mantenimiento activo. El último commit de pixelfin fue el 23 oct 2026.
¿Para qué puedo usar pixelfin?
Encontrar pósteres y Backdrop de baja resolución o que faltan en una biblioteca grande de Jellyfin. Crear copias de seguridad de las imágenes antes de reconstruir o migrar un servidor Jellyfin. Restaurar imágenes desde un ZIP después de migrar un servidor, empezando por una simulación. Mantener imágenes coherentes en toda una biblioteca mediante una revisión visual.
¿Cómo se instala pixelfin?
Instala las dependencias de Python desde requirements.txt: pip install -r requirements.txt Inicia Pixelfin: python app.py Abre la aplicación web en tu navegador
¿Dónde consigo pixelfin?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/nothing2obvi/pixelfin

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados