Live Wallpaper de Kwiq

Activación

El Live Wallpaper de Kwiq se puede activar de dos formas:

1. Desde el selector de fondos de Android: ve a Ajustes > Fondo de pantalla > Live Wallpapers y elige "Kwiq Live Wallpaper".
2. Desde el centro de ajustes de Kwiq: abre los Ajustes de Kwiq, ve a "Fondo de pantalla" y toca "Activar Live Wallpaper".

Al activarlo, puedes configurar cada slot individualmente, elegir imágenes de la galería o de proveedores online, y ajustar los ajustes de presentación y superposición.

Los 4 Slots

Kwiq tiene 4 slots de fondo de pantalla que se adaptan al contexto del dispositivo:

Kwiq selecciona automáticamente el slot correcto según el tema (claro/oscuro) y la orientación del dispositivo (retrato/paisaje).

Fallback inteligente: si un slot está vacío, el sistema intenta, en este orden:

1. Mismo tema con orientación opuesta
2. Tema opuesto con la misma orientación
3. Tema opuesto con orientación opuesta

Esto garantiza que nunca haya un fondo en blanco, incluso si solo has configurado un único slot.

Presentación

Cada slot puede contener múltiples imágenes que forman una presentación en bucle. Características principales:

• Tiempo por imagen: cada fondo puede tener su propia duración de visualización, de 5 segundos a 1 hora, configurada por fondo.
• Transición: crossfade suave de 220ms entre imágenes.
• Avance manual: en cualquier momento puedes avanzar manualmente a la siguiente imagen desde el acceso directo de fondo de pantalla en las Quick Tools.
• Bucle automático: la presentación se repite infinitamente, reiniciando desde el principio al llegar al final.

Proveedores de Imagen

Kwiq ofrece 12 fuentes para buscar fondos directamente desde la app. Los proveedores enfocados en anime (Waifu.im y Safebooru, además de Wallhaven con su categoría Anime) se agrupan en un submenú "Anime" desplegable para un acceso más rápido. Cada proveedor tiene sus propias opciones de filtro:

Los proveedores enfocados en anime (Waifu.im, Safebooru y un acceso directo de Wallhaven preconfigurado con la categoría Anime) se agrupan en un submenú Anime desplegable en el selector de proveedores para un acceso rápido.

Claves de API

Los proveedores Unsplash, Pixabay y Pexels requieren que crees una cuenta y obtengas tus propias claves de API. Así se obtiene cada una:

Unsplash

1. Accede a https://unsplash.com/developers
2. Crea una cuenta o inicia sesión en Unsplash.
3. Registra una aplicación en "Your Apps" > "New Application".
4. Copia la "Access Key" generada.
5. Pégala en los Ajustes de Kwiq > "Claves de API" > "Unsplash".

Pixabay

1. Accede a https://pixabay.com/api/docs/
2. Crea una cuenta o inicia sesión en Pixabay.
3. Copia tu clave de API en "API Key" en la página de documentación.
4. Pégala en los Ajustes de Kwiq > "Claves de API" > "Pixabay".

Pexels

1. Accede a https://www.pexels.com/api/
2. Crea una cuenta o inicia sesión en Pexels.
3. Solicita una clave de API gratuita.
4. Copia la clave proporcionada.
5. Pégala en los Ajustes de Kwiq > "Claves de API" > "Pexels".

Wallhaven y Waifu.im no requieren clave de API, pero ofrecen filtros avanzados como categoría, pureza (SFW/Sketchy/NSFW), orden y modo NSFW. Los demás proveedores (Safebooru, Wikimedia Commons, Openverse, Picsum Photos, LoremFlickr) también son gratuitos y sin clave.

Indicador de Batería Líquida

Convierte la pantalla de bloqueo del Live Wallpaper en un medidor de batería sutil y elegante:

• Activación: en los Ajustes de Kwiq > Fondo de pantalla > "Batería Líquida".
• Tipo de relleno: opaco o transparente.

Colores dinámicos: el color del líquido cambia según el nivel de batería:

• Rojo: ≤ 5%
• Naranja: ≤ 10%
• Amarillo: ≤ 20%
• Azul: mientras carga

• Efecto Caffeine: cuando Caffeine está activo, aparecen ondas de "vapor" en el líquido (colores disponibles: Coffee, CoffeeMilk, Milk o el color de acento).
• Burbujas: aparecen cuando el dispositivo está cargando.

Sistema de Presets

Los presets permiten guardar y restaurar configuraciones completas de fondo de pantalla: los 4 slots con imágenes, configuración por fondo y preferencias de recorte.

Estructura de carpetas:

Operaciones disponibles:

1. Guardar preset: copia los fondos de los slots activos al directorio del preset.
2. Aplicar preset: copia los archivos del preset a los slots activos, preservando toda la configuración por fondo.
3. Guardar actual como preset: misma lógica que Guardar, pero marca el preset como activo.
4. Renombrar / Eliminar: gestiona los presets existentes.
5. Exportar como ZIP: comprime todo el preset para compartir.
6. Importar desde ZIP: restaura un preset desde un archivo ZIP.
7. Compartir: envía el preset por Bluetooth, correo, etc.

El preset activo se rastrea automáticamente: al aplicar un preset, este se convierte en el "activo". Puedes ver qué preset está activo en los ajustes de fondo de pantalla.

Metadados dos Wallpapers

Cada fondo tiene sus propias configuraciones: posición en la secuencia, opacidad de superposición, duración de visualización, desplazamiento panorámico y nivel de zoom — así cada imagen recuerda su configuración para la presentación.

Fondo Estático

Kwiq también ofrece un selector de fondo estático tradicional para quien prefiera no usar el Live Wallpaper:

• Acceso: desde el centro de fondos de Kwiq (Ajustes > Fondo de pantalla > "Elegir Estático").
• Destinos: Pantalla de inicio (Home), Pantalla de bloqueo (Lock) o ambas.
• Ajustes: recorte, zoom y desplazamiento (arrastrar) para posicionar la imagen perfectamente antes de aplicar.
• Fuentes: galería del dispositivo o cualquier proveedor online configurado.

Copia de Seguridad y Restauración

La configuración de fondos se incluye en el sistema de copia de seguridad de Kwiq:

• Qué se guarda: presets de fondos y preferencias de batería líquida.
• Qué NO se guarda: las imágenes en sí (ya están en la carpeta Kwiq/Wallpapers/ en el almacenamiento y siguen visibles para el usuario).
• Formato: archivo .kwiqbkp.
• Restauración: al importar una copia de seguridad, los presets y ajustes se restauran automáticamente.

Web Wallpaper

Kwiq es compatible con web wallpapers — temas animados hechos con HTML, CSS y JavaScript, al estilo de Wallpaper Engine para escritorio. Se ejecutan en segundo plano usando una WebView invisible y pueden reaccionar a audio, toque y configuraciones personalizadas.

Cómo importar

1. Empaqueta tus archivos (index.html + assets) en un archivo .zip.
2. En la app, abre el panel de fondos y toca "Importar Web Wallpaper (ZIP)".
3. Selecciona el archivo ZIP — Kwiq lo extrae y registra automáticamente.
4. Asigna el web wallpaper a un slot en la configuración de fondos.

También puedes importar mediante MCP (web_wallpaper_import) o el Kwiq Dashboard (ruta POST /api/web-wallpapers/import).

Propiedades personalizadas

Los web wallpapers pueden exponer controles que aparecen en la interfaz de Kwiq como sliders, colores, botones y selectores. Simplemente registra las propiedades mediante window.wallpaperRegisterProperties() en JavaScript e incluye la sección properties en project.json.

Reacción a audio (FFT)

Kwiq captura el espectro de audio del dispositivo (32 bins FFT) y lo pone a disposición del web wallpaper mediante window.wallpaperRegisterAudioListener(). Usa los datos para crear visualizaciones, ondas reactivas, pulsos y cualquier efecto sincronizado con la música o sonidos circundantes.

APIs de JavaScript disponibles

• window.wallpaperRegisterProperties(properties[]) — registra propiedades personalizadas
• window.wallpaperPropertyListener — objeto para recibir cambios de propiedades
• window.wallpaperRegisterAudioListener(callback) — recibe array FFT de 32 bins en tiempo real
• window.wallpaperRegisterPauseListener(callback) — notifica cuando el fondo entra/sale de pausa

Estructura de archivos

El fondo se almacena en Kwiq/Wallpapers/{nombre}/ con la siguiente estructura:

Kwiq/Wallpapers/MiFondo/
  index.html      (obligatorio)
  project.json    (manifiesto de Wallpaper Engine — opcional)
  web.json        (manifiesto de Kwiq — generado automáticamente)
  assets/         (archivos auxiliares — CSS, JS, imágenes)

Gestión

• Listar: panel de fondos, MCP (web_wallpaper_list) o Dashboard
• Asignar a slot: MCP (web_wallpaper_assign) o Dashboard
• Eliminar: MCP (web_wallpaper_delete) o Dashboard — elimina de todos los slots y borra los archivos