Komorebi es un gestor de fondos de pantalla animados para Linux, diseñado específicamente para entornos Wayland (principalmente GNOME). Permite establecer videos como fondo de escritorio de manera eficiente, elegante y con un bajo consumo de recursos.
El nombre Komorebi (木漏れ日) es una palabra japonesa que describe la luz del sol que se filtra a través de las hojas de los árboles.
- 🎥 Soporte de Video: Reproduce archivos MP4, MKV, MOV, WEBM y más como fondo de pantalla.
- 🖥️ Multi-Monitor Avanzado:
- Configura un fondo diferente y único para cada pantalla conectada.
- Soporte Hot-Plug: Detecta automáticamente la conexión y desconexión de monitores, manteniendo la estabilidad de los fondos en las pantallas restantes sin interrupciones.
- ⚡ Rendimiento y Eficiencia:
- Pausa Inteligente: Pausa automática cuando hay ventanas maximizadas para no consumir recursos innecesarios.
- Modo Ahorro de Energía: Detecta si estás usando batería (en portátiles) y pausa los fondos automáticamente.
- Límite de FPS: Opción experimental para limitar la tasa de cuadros y reducir el uso de CPU/GPU.
- 📂 Gestión de Biblioteca:
- Importa videos individuales o carpetas completas.
- Los videos se organizan automáticamente en
~/Videos/Komorebi. - Generación automática de miniaturas (thumbnails).
- 🎛️ Control Total:
- System Tray: La aplicación se ejecuta en segundo plano con un icono en la bandeja del sistema.
- Audio: Control de volumen independiente y opción de silenciar.
- Interfaz Moderna: GUI oscura y minimalista basada en PySide6.
- Sistema Operativo: Linux.
- Sesión Gráfica: Wayland (Probado y optimizado para GNOME Shell).
- Python: 3.13 o superior (ver
requires-pythonenpyproject.toml). - Dependencias del Sistema:
ffmpeg(miniaturas / thumbnails).vlc(reproducción en el servicio de fondo vía libVLC).x11-utilsyx11-xserver-utils(usaxprop/xrandren Wayland + XWayland).- Qt en modo XCB (XWayland): en algunas distros se requieren libs adicionales para el plugin
xcb.
La forma más sencilla de instalar Komorebi es utilizando el instalador incluido.
-
Clonar el repositorio:
git clone https://github.com/evergaster/komorebi.git cd komorebi -
Ejecutar el instalador:
chmod +x install.sh ./install.sh
El script te guiará a través de un menú simple donde podrás elegir instalar o desinstalar la aplicación. Se encargará automáticamente de:
- Instalar dependencias del sistema (VLC, Python, etc.) para Arch, Fedora, Debian y Ubuntu.
- Crear un entorno virtual de Python aislado en
~/.local/share/komorebi/.venv. - Instalar dependencias Python desde
pyproject.toml(y algunas librerías extra necesarias para runtime). - Crear el acceso directo en el menú de aplicaciones ("Komorebi Wallpaper").
Si prefieres instalarlo manualmente o usas una distribución no soportada por el script:
-
Instalar dependencias del sistema:
- Debian/Ubuntu:
sudo apt install python3 python3-pip python3-venv vlc ffmpeg - Fedora:
sudo dnf install python3 python3-pip vlc ffmpeg - Arch:
sudo pacman -S python python-pip vlc ffmpeg
- Debian/Ubuntu:
-
Configurar entorno Python:
python3 -m venv .venv source .venv/bin/activate pip install --upgrade pip wheel pip install -e . setproctitle # Recomendado (mejor integración X11/XWayland): pip install python-xlib
-
Ejecutar:
python3 main.py
Si estás en Wayland y no ves el fondo, prueba forzar XWayland para la ventana de fondo:
QT_QPA_PLATFORM=xcb python3 main.py
Para iniciar la aplicación, simplemente busca "Komorebi" en tu menú de aplicaciones (si usaste el instalador) o ejecútalo desde la terminal.
python3 main.pyTip: también puedes usar el wrapper run_komorebi.sh (exporta QT_QPA_PLATFORM=xcb automáticamente):
./run_komorebi.sh- Añadir Fondos:
- Usa el botón "+ Importar Video" para añadir un archivo suelto.
- Usa "📂 Importar Carpeta" para escanear y añadir múltiples videos a la vez.
- Aplicar Fondo:
- Selecciona el monitor deseado en la parte superior (1, 2, etc.).
- Haz clic en el botón "Aplicar" de la tarjeta del video que quieras usar.
- Configuración:
- Ve a la pestaña "⚙ Configuración" para activar el inicio automático, el modo de ahorro de energía o ajustar el volumen.
Nota: Al cerrar la ventana principal, Komorebi seguirá ejecutándose en la bandeja del sistema. Para cerrarlo totalmente, haz clic derecho en el icono de la bandeja y selecciona "Salir Totalmente".
Este proyecto ha sido construido utilizando:
- Python: Lógica principal.
- PySide6 (Qt for Python): Interfaz gráfica y motor multimedia.
- FFmpeg: Procesamiento de video para miniaturas.
- psutil: Monitorización del estado de la batería.
¡Las contribuciones son bienvenidas! Si tienes ideas para mejorar Komorebi:
- Haz un Fork del repositorio.
- Crea una rama para tu característica (
git checkout -b feature/AmazingFeature). - Haz Commit de tus cambios (
git commit -m 'Add some AmazingFeature'). - Haz Push a la rama (
git push origin feature/AmazingFeature). - Abre un Pull Request.
Si encuentras algún error, por favor repórtalo en la sección de Issues.
Hecho con ❤️ por Evergaster.