ZR Music PRO
Reproductor profesional desarrollado en Python con arquitectura modular, sistema avanzado de descargas, manejo global de errores y motor optimizado para una experiencia estable y fluida en Windows.
🖥 Instalador Profesional
ZR Music incluye un instalador independiente optimizado para Windows 10 y 11.
El sistema verifica rutas, crea directorios necesarios, configura dependencias internas y deja la aplicación lista para ejecutarse sin configuración manual.
Incluye barra de progreso en tiempo real y control de versiones.
🧠 Arquitectura Modular
Construido bajo un enfoque modular separando lógica de interfaz, reproducción y descargas.
- ✔ UI basada en PySide6 (Qt)
- ✔ Separación por módulos (ui / core / themes)
- ✔ Gestión global de excepciones
- ✔ Sistema de logging persistente
- ✔ Manejo seguro de rutas empaquetadas
- ✔ Configuración en archivo JSON
La estructura permite escalabilidad futura y mantenimiento limpio del código.
🎵 Motor de Reproducción
Utiliza pygame mixer optimizado para baja latencia y estabilidad.
- ✔ Barra de progreso sincronizada
- ✔ Control preciso de volumen
- ✔ Shuffle inteligente
- ✔ Repeat individual y global
- ✔ Lectura automática de metadata (Mutagen)
El sistema mantiene sincronización incluso al cambiar canciones manualmente.
⬇ Sistema de Descargas
Integración directa con yt-dlp para descargar contenido desde YouTube.
- ✔ Selección automática de calidad
- ✔ Conversión optimizada a MP3
- ✔ Gestión automática de nombres
- ✔ Protección ante errores de red
Los errores críticos son registrados automáticamente en logs.
🔐 Estabilidad y Seguridad
Implementa un manejador global de excepciones para evitar cierres inesperados.
- ✔ try/except centralizado
- ✔ Registro automático en logs/app.log
- ✔ Protección ante KeyboardInterrupt
- ✔ Manejo seguro de recursos empaquetados
Garantiza una experiencia estable incluso en condiciones no ideales.
📦 Especificaciones Técnicas
Requisitos del Sistema
- Windows 10 / 11 (64 bits)
- Procesador x64
- 200 MB libres
- Conexión a internet
Tecnologías Utilizadas
- Python 3.11
- PySide6
- pygame
- yt-dlp
- mutagen
- PyInstaller
Tamaño Aproximado
- Installer: ~30–40 MB
- Instalación final: ~150–200 MB
🚀 Roadmap Futuro
- 🔹 Sistema de actualizaciones automáticas
- 🔹 Visualizador de audio en tiempo real
- 🔹 Temas dinámicos personalizables
- 🔹 Integración con APIs externas
- 🔹 Versión multiplataforma
ZR Music es un proyecto en evolución constante.