Fondos de pantalla
El núcleo de fondos davinci, xwww y mpvpaper, el selector de Quickshell, los proveedores de búsqueda y la presentación de diapositivas.
Los fondos de pantalla se gestionan con equisdots/davinci, un núcleo sin interfaz que aplica, genera miniaturas, busca y rota fondos de pantalla. El selector de Quickshell es solo un frontend: la interfaz decide qué aplicar y el núcleo decide cómo.
La pila
| Pieza | Función |
|---|---|
xwww / xwww-daemon |
Aplica imágenes fijas y escenas interactivas. |
mpvpaper |
Aplica fondos de vídeo. |
| ImageMagick, ffmpeg, ffprobe | Miniaturas, conversión a webp y pósteres de vídeo. |
davinci |
CLI del núcleo: listado, aplicación, estado, búsqueda y presentación. |
| Selector de Quickshell | SUPER + W, cuadrícula de tarjetas con filtros y transiciones. |
El demonio se inicia desde autostart.lua de Hyprland (o autostart.kdl de
niri) y el shell lo reinicia tras los cambios de tema. El stack de fondos es
neutral al compositor: corre igual en Hyprland y niri.
El directorio de fondos de pantalla
La colección está en ~/.config/hypr/wallpapers por defecto y se escanea
recursivamente. Los archivos anidados se aplanan en el nombre de su miniatura
usando __ como separador (sub/dir/pic.jpg pasa a ser
sub__dir__pic.jpg). Un directorio que contiene scene.js es una escena
interactiva; su miniatura se llama scn_<name>.jpg, mientras que los vídeos
usan el prefijo 000_.
CLI
davinci set <file|url|scene-dir> [--video] [--monitors all|A,B] \
[--transition name] [--thumb <poster>] [--notify] [--dry-run]
davinci set ~/.config/hypr/wallpapers/astro-palette --transition decrypt
davinci fetch --name <n> --map <f> --dest <f>
davinci current
davinci current --thumb-name
davinci thumbs
davinci search "mountains" --source wallhaven
davinci search --continue "mountains"
davinci search --clear
davinci stop
davinci rm ~/.config/hypr/wallpapers/nord.png
davinci import ~/Downloads/*.jpg
davinci slideshow start|stop|status [interval]
davinci keys list
davinci keys set PIXABAY_KEY <value>
davinci paths
davinci --version
set acepta un archivo, una URL o un directorio de escena y resuelve el
destino por sí mismo; --monitors, --thumb, --notify y --dry-run
refinan la aplicación. --transition acepta el conjunto de xwww (fade,
wipe, glitch, decrypt y más) más random; vacío significa aleatorio.
fetch es el descargador que el selector llama tras elegir un resultado, y
keys gestiona las claves de proveedor en keys.conf. El selector resuelve
la CLI mediante $DAVINCI_CLI y luego un ../kernel/davinci.sh hermano, así
que otros frontends solo necesitan la ruta.
Anulaciones de entorno
| Variable | Valor predeterminado | Uso |
|---|---|---|
DAVINCI_WALLPAPER_DIR |
$WALLPAPER_DIR o ~/.config/hypr/wallpapers |
Directorio de origen. |
DAVINCI_CACHE_DIR |
~/.cache/quickshell/wallpaper_picker |
Miniaturas, fondo actual y búsqueda. |
DAVINCI_STATE_DIR |
~/.local/state/quickshell/wallpaper_picker |
Indicadores persistentes y current_scene. |
DAVINCI_RUN_DIR |
$XDG_RUNTIME_DIR/quickshell/wallpaper_picker |
Archivos de control, bloqueos y PIDs. |
DAVINCI_LOG_DIR |
$XDG_RUNTIME_DIR/quickshell/logs |
Registros del núcleo. |
DAVINCI_XWWW |
~/.local/bin/xwww, luego PATH |
Binario del cliente. |
DAVINCI_XWWW_DAEMON |
~/.local/bin/xwww-daemon, luego PATH |
Binario del demonio. |
DAVINCI_CLI |
— | Ruta explícita a davinci.sh que consume el selector. |
El selector
Ábralo con SUPER + W. El selector muestra las miniaturas de davinci, un
selector de transición y controles de filtro. Las tarjetas llevan una insignia
JS para las escenas y una insignia de reproducción para los vídeos. La
aplicación se realiza con un clic o Return; Delete mueve la entrada
seleccionada a la papelera mediante davinci rm. El fondo activo se
preselecciona al abrir el selector (davinci current --thumb-name).
Búsqueda
Las descargas de búsqueda pasan por scripts de proveedor en providers/:
| Fuente | Clave | Notas |
|---|---|---|
ddg |
ninguna | Scraper de DuckDuckGo, solo biblioteca estándar. |
wallhaven |
ninguna (SFW) | Filtro de resolución nativa y paginación. |
pexels |
PEXELS_KEY opcional |
Vídeos de stock; mejor mp4 >= 1920x1080. |
pixabay |
PIXABAY_KEY |
Vídeos de stock; mejor variante >= 1920x1080. |
Las claves viven en $DAVINCI_STATE_DIR/keys.conf o en el entorno. Los
resultados se filtran a al menos 1920x1080 y se validan (content-type más
mime) antes de conservarlos. La paginación guarda un cursor por proveedor en
search_cursors/<source>, y el proveedor activo se persiste en search_source
para que search --continue pregunte a la misma fuente.
Presentación de diapositivas
davinci slideshow start [interval] ejecuta un demonio independiente que rota
imágenes fijas con una transición aleatoria y nunca repite la anterior. El
estado vive en slideshow.pid y slideshow_enabled bajo los directorios de
ejecución y estado. La presentación omite las escenas.
Contratos y archivos de estado
current_wallpaper.pngen el directorio de caché es el fotograma que usan la pantalla de bloqueo y SDDM.current_sceneen el directorio de estado contiene el directorio de la escena en ejecución; aplicar una imagen o un vídeo lo elimina.thumbs/.manifestythumbs/.source_dirindexan la caché de miniaturas.search_map.txtalmacenaname|urlpara los resultados de búsqueda.ddg_search_controlllevarun,pauseostop, escrito por la interfaz.search_cursors/<source>ysearch_sourcepersisten la paginación y el proveedor.slideshow.pidyslideshow_enabledguardan el estado del demonio de diapositivas.keys.conf(modo 600) almacena las claves de API de los proveedores.
Contribuir con fondos de pantalla
El repositorio background alberga la colección de fondos y el catálogo de escenas. Las imágenes se distribuyen como assets de release, nunca se rastrean en git:
- Envíe solo imágenes creadas por usted o con licencia explícita para su redistribución; se rechaza la procedencia poco clara.
- JPEG (optimizado), 4K preferido y 2560x1440 mínimo, 16:9 o más ancho, menos de unos 5 MB, sin marcas de agua.
- Abra un PR o issue titulado
wallpaper: <nombre corto>, adjunte la imagen e incluya autor, fuente, licencia y una descripción breve. - Las releases publicadas incluyen
LICENSEyCREDITS.md; las imágenes y la documentación se licencian CC BY 4.0 y cada autor recibe crédito.
Solución de problemas
- El fondo no cambia: compruebe que
xwww-daemonse ejecuta y quexwww --versioncoincide con la versión fijada (dots doctorlo informa). davinci: xwww not found(no se encuentra xwww): el núcleo resuelveDAVINCI_XWWW, luego~/.local/bin/xwwwy luegoPATH; puede que una sesión no incluya~/.local/bin.- Falla el fondo de vídeo:
mpvpaperdebe estar instalado (dots system). - Miniaturas ausentes u obsoletas: ejecute
davinci thumbs. - La escena aparece como una carpeta normal: necesita un archivo
scene.js; consulte Escenas interactivas.
Siguientes pasos
- Escenas interactivas para fondos de pantalla procedurales.
- Temas y paletas para escenas reactivas a la paleta.
- Shell Quickshell para el selector y la gestión de estado.