Introducción

Bueno, después de un tiempo usando Hyprland y configurando todo a mano editando archivos de texto, me decidí a crear algo que me facilitara la vida. Así nació vsHyprland Manager.

La idea era simple: quería una herramienta visual que me dejara modificar la configuración de Hyprland sin tener que recordar cada opción del archivo hyprland.conf. Nada de buscar en la documentación cada vez que quería cambiar algo.

¿Qué es vsHyprland Manager?

Es un editor visual de configuración para Hyprland, escrito en Python 3 con GTK3. Lo que hace es trabajar con módulos separados en ~/.config/hypr/modules/, lo que facilita mucho tener todo organizado y poder hacer cambios sin romper la configuración principal.

Lo más cool es que tiene un preview strip que te muestra los cambios en tiempo real antes de aplicarlos. Así no tienes que andar adivinando si quedó bien o no.

Secciones que puedes editar

La herramienta cubre prácticamente toda la configuración de Hyprland:

• Appearance — Colores, bordes, gaps
• Animations — Transiciones y animaciones de ventanas
• Input — Teclado, mouse, touchpad
• Monitors — Configuración de pantallas
• Keybindings — Atajos de teclado
• Rules — Regillas para ventanas
• Autostart — Aplicaciones que inician con el sistema
• Environment — Variables de entorno
• Plugins — Gestión de plugins
• Scripts — Scripts personalizados
• Hot Corners — Esquinas activas

Sistema de respaldos

Algo que me dio mucha paz mental fue implementar un sistema de respaldos automático. Al iniciar, hace un respaldo de tu configuración original en ~/.config/hypr/backups/original/. Y cada vez que aplicas cambios, crea un respaldo con fecha y hora. Así si algo sale mal, siempre puedes volver atrás.

Instalación

AUR (Arch Linux)

yay -S vshyprland-manager

Manual

git clone https://github.com/victorsosaMx/vsHyprland-Manager.git
cd vsHyprland-Manager
pip install -r requirements.txt
python vsHyprland-Manager.py

Requisitos

• Python 3.10+
• python-gobject
• python-cairo
• Hyprland

Integración con vsHub

Algo que también implementé es la integración con vsHub, un sistema de descubrimiento que te permite encontrar y gestionar otras herramientas de la suite vsHyprSettings. Así todas mis herramientas se complementan entre sí.

Detalles técnicos

El proyecto está escrito en un solo archivo de Python para mantenerlo simple y fácil de mantener. La interfaz usa GTK3 puro, sin depender de frameworks pesados. Los módulos de configuración se cargan dinámicamente, lo que hace fácil agregar nuevas secciones sin tocar el código principal.

Agradecimientos

Este proyecto no habría sido posible sin:

• El equipo de Hyprland por crear un window manager increíble
• La comunidad de Arch Linux por el soporte y feedback constante
• Todos los que han contribuido con ideas y reportes de bugs

Licencia

MIT License

Enlaces

• Repositorio: github.com/victorsosaMx/vsHyprland-Manager
• Parte de: Suite vsHyprSettings

Espero que les sea tan útil como a mí. Cualquier bug o sugerencia, abrans un issue en el repositorio. ¡Saludos!