🖼️ ICO Converter

Aplicación de escritorio profesional para convertir imágenes a iconos .ico, desarrollada en Python con Tkinter, pensada para ofrecer una experiencia moderna, segura y robusta.

---

---

---

✨ Características principales

• 🎯 Conversión precisa y rápida a .ico

  • Genera iconos multiresolución listos para Windows.

• 🖱️ Drag & Drop intuitivo

  • Arrastra una imagen directamente a la aplicación.
  • Soporte visual claro y estados bien definidos.

• 🧠 Validación inteligente de imágenes

  • Rechazo automático de formatos incompatibles (por ejemplo .ico).
  • Solo se aceptan imágenes válidas: PNG, JPG, JPEG.

• 🚫 Protección contra errores comunes

  • Evita convertir archivos inválidos.
  • Mensajes claros y traducidos para el usuario.

• 🌍 Internacionalización (i18n)

  • Sistema de traducciones basado en JSON.
  • Idioma por defecto: Español (listo para ampliar).

• 🖼️ UI optimizada para HiDPI

  • Conciencia de DPI en Windows.
  • Assets preparados para pantallas de alta resolución.

• 🧩 Arquitectura modular y profesional

  • Separación clara entre UI, lógica, validación y procesamiento.
  • Código mantenible y escalable.

• 📂 Acceso rápido a resultados

  • Botón para abrir directamente la carpeta del icono generado.

• 📝 Logging interno

  • Registro de eventos y errores para depuración profesional.

• 📦 Ejecutable .exe portable (no requiere instalación)

• 🧩 Todo el runtime embebido (PyInstaller one-file)

• 🖼️ Interfaz gráfica con Tkinter

• 🔐 Ejecutable firmado digitalmente (Code Signing)

• 🪟 Compatible con Windows 10 / 11

---

🗂️ Formatos soportados

✅ Imágenes de entrada

• .png
• .jpg
• .jpeg

❌ Formatos rechazados

• .ico
• Cualquier archivo no reconocido como imagen válida

---

---

🖥 Interfaz de usuario

ICO Converter cuenta con una interfaz gráfica moderna basada en Tkinter, diseñada para ofrecer claridad visual, consistencia y una experiencia profesional.

Elementos destacados

• 🎯 Área Drag & Drop central con texto descriptivo en dos líneas
• 🖱️ Soporte para arrastrar archivos o seleccionarlos manualmente
• 🪟 Ventanas modales personalizadas para errores y advertencias
• 🧠 Mensajes claros y no ambiguos para cada acción
• 🖥️ Compatibilidad completa con pantallas HiDPI (Windows 10 / 11)
• La estética es minimalista y funcional, enfocada en productividad.

La interfaz está optimizada para pantallas HiDPI, con renderizado mejorado de imágenes, sombras y relieve visual.

---

📷 Capturas de pantalla

---

---

▶️ Ejecución

• Opción 1: Desde código fuente (desarrolladores)

Requiere:

* 🐍 Python **3.11**
* Entorno virtual activo

  py -3.11 -m venv venv
  .\venv\Scripts\Activate.ps1
  pip install -r requirements.txt
  python .\main.py

* Dependencias instaladas

• Opción 2: Ejecutable (.exe) – recomendado

El proyecto está preparado para distribuirse como archivo ejecutable (.exe) para Windows.

Ventajas:

• ✅ No requiere Python instalado
• ✅ Mantiene Drag & Drop
• ✅ Incluye assets, fuentes e idiomas
• ✅ Ideal para usuarios finales
• ✅ Ejecutable totalmente portable
• ✅ Listo para usar al descargar

⬇️ Descarga

• El ejecutable ICO_Converter.exe se publica en la sección Releases del repositorio.

• Opción 3: Script VBScript (alternativa)

Puede incluirse un archivo .vbs que lance la aplicación Python de forma transparente, útil en entornos corporativos o controlados.

---

---

🛠️ Información de Compilación

El ejecutable fue construido utilizando:

• 🐍 Python 3.11
• 📄 PyInstaller (modo one-file)
• Windows SDK (signtool) para firma digital
• Entorno Windows 10 / 11

---

---

📁 Estructura del proyecto

Ico_Converter/
├─ app/
│  ├─ about_window.py        # Ventana "Acerca de"
│  ├─ controller.py          # Controlador principal
│  ├─ dialogs.py             # Diálogos personalizados
│  └─ main_window.py         # Interfaz principal
│
├─ assets/
│  ├─ fonts/                # Fuentes personalizadas
│  └─ images/               # Iconos e ilustraciones
│
├─ config/
│  └─ settings.py           # Configuración global
│
├─ core/
│  ├─ dpi.py                # Manejo HiDPI
│  ├─ fonts.py              # Gestión tipográfica
│  ├─ i18n.py               # Internacionalización
│  ├─ ico_converter.py      # Conversión a .ico
│  ├─ image_enhancer.py     # Mejora de imagen
│  ├─ image_manager.py      # Gestión de recursos e imágenes
│  ├─ image_preprocess.py   # Preprocesamiento
│  ├─ image_processor.py    # Pipeline principal
│  ├─ image_session.py      # Sesión de trabajo
│  ├─ image_validator.py    # Validación de formatos
│  ├─ logger.py             # Logging
│  └─ utils.py              # Utilidades
│
├─ locales/
│  ├─ en.json
│  ├─ es.json
│  ├─ de.json
│  ├─ fr.json
│  ├─ it.json
│  └─ pt.json
│
├─ venv/                    # Entorno virtual (no distribuido)
├─ main.py                  # Punto de entrada
├─ requirements.txt         # Dependencias
├─ README.md
└─ RELEASE_DESCRIPTION.md 

---

🛠️ Requisitos Técnicos

• 🐍 Python: 3.11 (recomendado, probado)
• 🪟 Sistema operativo: Windows 10 / 11
• 🖥️ Arquitectura: x64

---

---

📦 Dependencias principales:

pillow==12.1.0
tkinterdnd2==0.4.3

python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt

---

Usuarios finales

➡️ Ningún requisito adicional al usar el ejecutable publicado en Releases.

---

🔐 Seguridad y Confianza

Este proyecto distribuye un ejecutable firmado digitalmente para garantizar:

• ✔ Integridad del archivo (no ha sido modificado)
• ✔ Autenticidad del origen
• ✔ Reducción de advertencias de Windows SmartScreen
• ✔ Mayor confianza al ejecutar el programa

---

---

📦 Portabilidad

• Este software es 100% portable:
• No crea carpetas en el sistema
• No modifica el registro de Windows
• No requiere dependencias externas
• Puede ejecutarse desde USB o cualquier carpeta

---

---

👨‍💻 Autor

• Nombre: Pablo Téllez
• Contacto: pharmakoz@gmail.com

📍 Tarija, Bolivia — 2026

---

⭐ Estado del proyecto

✔ Estable ✔ En producción ✔ Orientado a uso profesional

---

⭐ Si este proyecto te resulta útil, considera dejar una estrella en el repositorio.

📄 Licencia

Este proyecto se distribuye bajo la licencia MIT.

---