vsHypr Theme Manager: un sistema de temas completo para Hyprland

Introducción

Después de pasar demasiado tiempo ajustando colores app por app, quise resolver ese problema de raíz. Así nació vsHypr Theme Manager, una herramienta pensada para aplicar un tema completo en un entorno Arch Linux + Hyprland sin tener que ir archivo por archivo.

La idea no era solamente cambiar un wallpaper bonito, sino lograr que terminal, barra, notificaciones, launcher, lock screen y apps GTK/Qt hablaran el mismo lenguaje visual.

¿Qué es vsHypr Theme Manager?

Es un gestor de temas visual que aplica esquemas de color de forma coordinada en varias piezas del escritorio. Está diseñado para trabajar de forma no destructiva, respetando la configuración existente y creando respaldos antes de tocar cualquier archivo.

Además de la interfaz gráfica, también puede ejecutarse por línea de comandos y tiene integración con Rofi para elegir temas desde un picker visual.

Características principales

Temas listos para usar

Incluye 44 temas integrados con estilos como Catppuccin, Dracula, Nord, Tokyo Night, Everforest y Kanagawa, entre otros.

Temas dinámicos desde el wallpaper

Si usas matugen, puedes generar un esquema dinámico a partir de cualquier fondo con variantes dynamic-dark y dynamic-light.

Aplicación no destructiva

La herramienta inyecta colores usando bloques marcados, así que tus cambios manuales fuera de esos bloques se conservan. No es el típico script que reescribe todo sin preguntar.

Sistema de respaldos serio

Guarda una copia original de cada archivo la primera vez y luego crea snapshots con fecha y hora antes de cada aplicación de tema. Eso da mucha tranquilidad cuando estás experimentando.

Integración con Rofi

Trae un selector visual con miniaturas, paletas de colores y atajos para aplicar solo el tema o tema + wallpaper.

Instalación de assets

También puede instalar archivos auxiliares para Rofi, Wlogout y scripts de Hyprland, todo desde la misma app.

Aplicaciones compatibles

Una de las cosas más interesantes del proyecto es que no se limita a una sola capa del sistema. Puede aplicar tema a herramientas como:

• Kitty
• Waybar
• SwayNC
• Hyprland
• Hyprlock
• Hyprswitch
• Rofi
• EWW
• Wlogout
• vsFetch
• GTK3 / GTK4 / libadwaita
• Qt5ct / Qt6ct / Kvantum
• kdeglobals

Eso lo vuelve mucho más útil cuando quieres un escritorio realmente coherente y no solo un parche cosmético.

Interfaz y flujo de trabajo

La app está organizada en varias pestañas como Setup, Config, Set Theme, Wallpaper, Assets, vsHub y About.

Desde ahí puedes:

• revisar dependencias faltantes
• configurar tu directorio de wallpapers
• aplicar temas estáticos o dinámicos
• instalar assets complementarios
• lanzar el picker de Rofi

En la práctica, el flujo es bastante simple: eliges un tema, lo previsualizas mentalmente con su paleta, lo aplicas y el sistema actualiza los componentes compatibles.

Instalación

AUR

yay -S vshypr-theme-manager

Manual

git clone https://github.com/victorsosaMx/vsHypr-Theme-Manager.git
cd vsHypr-Theme-Manager
python3 vshypr-theme-manager.py catppuccin

Requisitos

• Python 3
• GTK3 / PyGObject
• python-cairo
• Hyprland

Opcional

• matugen para temas dinámicos basados en wallpaper
• rofi para el selector visual
• awww para transiciones de wallpaper

Enlaces

• Repositorio: github.com/victorsosaMx/vsHypr-Theme-Manager
• AUR: aur.archlinux.org/packages/vshypr-theme-manager

Este proyecto me gusta porque resuelve un problema real del ecosistema Linux: conseguir consistencia visual sin convertir cada cambio de tema en una tarde completa editando configs. Si usan Hyprland y disfrutan personalizar su escritorio, vale mucho la pena probarlo.