plex-smart-logo-updater
Script Python para actualizar logos en bibliotecas de Plex, priorizando el idioma local y corrigiendo errores de Quebec con OCR. Incluye revisión manual previa y modo seguro (dry run) sin modificar datos hasta aprobación.
Ficha actualizada 24 sept 2026, 21:44 · upstream 24 sept 2026, 20:18 · release v1.3.1
Qué es plex-smart-logo-updater
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio contiene una herramienta diseñada para mejorar la calidad de los logos en las bibliotecas de Plex. El problema principal es que Plex a menudo asigna logos incorrectos, como los de Quebec en bibliotecas francesas, o no asigna ninguno cuando existe uno en inglés. La solución prioriza el idioma configurado en la biblioteca y utiliza un fallback automático al inglés si no hay opción local.
- Corregir automáticamente logos de Quebec en bibliotecas con idioma francés.
- Asignar logos a títulos que carecen de identidad visual en su idioma original.
- Mantener los logos bloqueados por el usuario, excepto si son detectados como incorrectos.
- Ejecutar actualizaciones periódicas mediante cron para mantener la base de datos sincronizada.
- Detección precisa de logos de Quebec mediante lectura OCR del texto en la imagen.
- Priorización automática: Idioma de la biblioteca primero, inglés como respaldo.
- Modo dry run que permite visualizar cambios antes de aplicarlos en el servidor.
- No requiere clave de TMDB, solo un token de autenticación de Plex.
- Requiere acceso directo al servidor Plex (localhost o SSH), no funciona como servicio web remoto sin túnel.
- El motor OCR puede fallar en logos con fuentes muy estilizadas o espaciadas, marcándolos como 'NOT VERIFIED'.
- La primera ejecución es lenta debido a la descarga de dependencias y lectura inicial de logos.
- Necesita revisión manual de los cambios propuestos antes de aplicarlos definitivamente.
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.
Instalar en Linux, macOS o WSL con Python 3.8+. Crear entorno virtual (.venv) y ejecutar install.sh. Configurar config.env con la dirección del servidor Plex (ej. http://127.0.0.1:32400) y el token de autenticación. Ejecutar siempre primero con --html para revisar los cambios en review.html antes de aplicarlos.
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.