vsWallpaper-Effect: efectos animados para tu wallpaper en Wayland

vsWallpaper-Effect: efectos animados para tu wallpaper en Wayland

Introducción

Hay veces que un wallpaper estático simplemente no alcanza para darle personalidad al escritorio. Quería algo más vivo, pero sin caer en soluciones pesadas o difíciles de configurar. De ahí salió vsWallpaper-Effect.

La idea fue crear un motor de efectos para Wayland que pudiera correr en segundo plano, con aceleración por GPU, y además ofrecer un editor gráfico para ajustar todo sin tocar JSON a mano.

¿Qué es vsWallpaper-Effect?

Es un motor de efectos animados para wallpapers con una interfaz en GTK3 y un daemon que se fija al fondo del escritorio usando gtk-layer-shell.

Funciona especialmente bien en Hyprland, aunque en general está pensado para compositores Wayland compatibles con layer-shell. El editor ofrece preview en vivo y el daemon puede arrancar automáticamente como servicio de usuario.


Efectos disponibles

Actualmente incluye 9 efectos integrados:

  • rain
  • matrix
  • aurora
  • warp
  • snow
  • gradient
  • stars
  • waves
  • droplets

Cada efecto expone parámetros como velocidad, opacidad, densidad, colores y posición vertical, así que no se queda en presets cerrados.


Características que más me gustaron del proyecto

Render por GPU

Los efectos corren con GLSL + OpenGL, lo que permite animaciones fluidas directamente sobre el wallpaper.

Live preview

Desde el editor puedes ver al instante cómo cambian los efectos mientras ajustas sliders y colores.

Soporte para imagen o slideshow

Se puede trabajar con una sola imagen o con una carpeta completa en modo rotación.

Daemon para el fondo

La app puede levantarse como daemon en segundo plano, ocupar la capa de fondo y funcionar con click-through.

Gestión de autostart

Desde la pestaña Setup se puede administrar el servicio systemd --user y desactivar temporalmente otros daemons de wallpaper que entren en conflicto.

Exportación y respaldo

Permite exportar la configuración para compartirla o guardarla como backup.


Requisitos

  • Python 3.10+
  • GTK3
  • python-gobject
  • gtk-layer-shell
  • python-cairo
  • PyOpenGL

Opcional

  • fontconfig para detección de fuentes en el efecto Matrix

Instalación

AUR

yay -S vswallpaper-effect

Manual

git clone https://github.com/victorsosaMx/vsWallpaper-Effect
cd vsWallpaper-Effect
pip install -e .

O también se puede ejecutar directamente:

chmod +x vswallpaper-effect
./vswallpaper-effect

Uso básico

Editor

./vswallpaper-effect

Daemon

./vswallpaper-effect --daemon --replace

Detener daemon

./vswallpaper-effect --stop

Enlaces


Este proyecto me parece especialmente divertido porque mezcla personalización visual con un enfoque técnico serio. Si usan Wayland y quieren que el escritorio tenga más atmósfera sin sacrificar control, vsWallpaper-Effect es una muy buena base para experimentar.

Víctor Sosa 11 April 2026 wallpaper, wayland, hyprland, python, gtk3, opengl permalink
Anterior vsIronbar Studio: editor visual para configurar Ironbar Siguiente vsReflector Manager: gestor visual de mirrors para Arch…