Skip to content

firogv96/images-py

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Utilidad de Imágenes Py

Preview del Proyecto

¿Qué es este programa?

Utilidad de Imágenes Py es una herramienta de escritorio diseñada para facilitar la conversión de imágenes de HEIC a JPG, renombrarlas y buscar duplicados. Proporciona una interfaz gráfica de usuario sencilla para realizar tareas que comúnmente requieren el uso de varias herramientas distintas o la línea de comandos, centralizando la agilización estas tareas. Además, la utilidad permite poner la interfaz en idiomas inglés y español, y en modo claro u oscuro.

¿Para qué se usa?

La herramienta ofrece tres funciones principales:

  1. Conversión de HEIC a JPG: Permite procesar archivos en formato HEIC (común en dispositivos Apple) y convertirlos a JPG, facilitando su visualización y compatibilidad universal en distintos entornos o dispositivos.
  2. Renombrado Inteligente: Renombra masivamente los archivos de imagen utilizando sus metadatos internos (EXIF) como su fecha de captura o modificación, lo que ayuda a mantener las bibliotecas de imágenes ordenadas cronológicamente y de manera uniforme.
  3. Búsqueda y Eliminación de Duplicados: Analiza directorios en busca de imágenes duplicadas empleando tres métodos de detección:
    • Exacta: Coincidencia bit a bit.
    • Visual: Similitud en los píxeles (permite encontrar imágenes similares aunque varíen sus resoluciones o formato).
    • Por Nombre: Para encontrar imágenes catalogadas igual en variados subdirectorios.

Una vez encontrados duplicados, la herramienta ofrece una interfaz visual que agrupa los resultados, permitiendo seleccionar rápidamente qué imagen conservar y procesando el resto a la papelera.

Descarga

Para usar la utilidad de forma sencilla, puedes descargar el ejecutable .exe directamente desde la sección de Releases.

¿Cómo se usa?

Para utilizar la herramienta:

  1. Inicie la aplicación (o su ejecutable). La interfaz principal se divide visualmente entre las distintas funciones mencionadas.
  2. Defina el directorio de origen que contenga las imágenes que requiere procesar, seleccionado o no el procesado por subcarpetas.
  3. Presione el botón de la acción a llevar a cabo luego de configurar sus parámetros.
  4. Para la búsqueda de duplicados: al finalizar el análisis automático, los resultados se mostrarán agrupados. Seleccione (en los botones de opción o "radio") de un mismo grupo aquella imagen que desea mantener (o deshabilite el grupo si desea resguardar ambas partes). Luego accione el botón de eliminar y las fotografías no marcadas irán a la papelera del sistema para recuperarse si existiese algún error de consideración por parte del usuario.

Sobre su Desarrollo

Este proyecto ha sido programado y creado con fines didácticos y para uso personal, buscando resolver las necesidades prácticas del creador y de otros usarios con similares necesidades. Su desarrollo, desde la arquitectura hasta la resolución de errores, se llevó a cabo íntegramente de la mano con Antigravity y Gemini AI, asistentes que codificaron la implementación de los algoritmos de lógica interna (backend) y toda la interfaz gráfica (frontend).

Tecnologías implementadas:

  • Python: Lenguaje principal manejando los sistemas de archivos y memoria.
  • Eel: Librería responsable de levantar un servidor unificado y enlazar el frontend web a Python.
  • Pillow & pillow-heif: Dependencias para manipulación de lectura/escritura de imágenes incluyendo soporte HEIC.
  • ImageHash: Cálculo de hashes visuales para inferir similitudes sin coincidir criptográficamente en un 100%.
  • HTML, CSS (Vanilla), JavaScript: Conjunto frontend responsable de la visualización, y toda la lógica de validación e interacción con el usuario.
  • Send2trash: Módulo de control para un borrado amigable del archivo sin ser destructivo.

Disclaimer de Responsabilidad

⚠️ IMPORTANTE - ADVERTENCIA: El uso, descarga e implementación del programa provisto es exclusivamente bajo su propio riesgo y discreción.

Se aclara explícitamente y el usuario toma en conocimiento de las siguientes pautas:

  • El creador no se responsabiliza de ninguna manera o concepto por el uso inadecuado o mal intencionado del software.
  • El creador declina toda responsabilidad por comportamientos impredecibles, fallos (bugs), o un uso incorrecto de la aplicación que pueda afectar la funcionalidad de la herramienta.
  • Se exime al creador de toda responsabilidad frente a todo tipo de pérdida de información, corrupción de datos y/o cualquier daño potencial a archivos, al hardware o a la red del usuario, así como de todo conflicto general originado mediante el software o procesos ligados a las alteraciones generadas.

Se recomienda enfáticamente y como una buena práctica poseer copias de respaldo (backups) de todas sus imágenes, directorios y archivos importantes garantizando así una capa de seguridad antes de llevar a cabo procesos de renombrado y eliminación masiva.

Créditos y Agradecimientos

Si este proyecto le es de una utilidad o decide basarse y/o modificar parte del código fuente disponible, se agradece especialmente citar a su creador.