Skip to content

Releases

WayWal v3.0.0

Choose a tag to compare

@Execorn Execorn released this 09 Nov 19:35

Added

  • WayWal Studio (wwal-studio) Desktop IDE: Native C++23 / Qt 6 workstation featuring dockable Workspace Presets (Browse, Inspect & Tune, Theme Lab), a 144 FPS Virtualized Media Grid with zero-copy DMA-BUF hover previews, a live GPU Preview Viewport, a Multi-Monitor Topology Canvas (Fill, Fit, Center, Stretch, Tile, Span), an interactive Cubic-Bezier Transition Curve Editor, a real-time Shader & Workshop Property Inspector, and a live Material Design 3 (OKLab / CAM16 / HCT) Theme Studio with WCAG 2.1 contrast auditing and dotfile template export.
  • Multi-Drive Steam Workshop (431960) Discovery & Hybrid Filesystem Watcher: Automatic parsing of Valve KeyValues VDF (libraryfolders.vdf, appworkshop_431960.acf) across all mounted Steam libraries, coupled with a hybrid fanotify (FAN_MARK_FILESYSTEM) and recursive inotify watcher with epoll + timerfd 300 ms debounce and 1,000 ms flush ceiling.
  • Embedded SQLite3 WAL + FTS5 Catalog Index: Sub-millisecond (< 0.1 ms at 50,000 items) full-text prefix search and multi-faceted filtering backed by 6 covering indices and zero-churn FTS5 synchronization triggers.
  • Multi-Backend Download & Subscription Queue Manager: 3-tier download arbitration (libsteam_api.so ISteamUGC runtime dlopen, Steam Web API + HTTP/2 byte-range resume worker with full-jitter HTTP 429 backoff, and asynchronous steamcmd pipe runner) governed by a Token Bucket bandwidth limiter and EWMA speed/ETA estimator.
  • WayWal Open Hub & Cryptographic .wwpkg Ecosystem: Open .wwpkg (tar.zst) wallpaper package container with RFC 8785 JSON Canonicalization Scheme (JCS), RFC 6962 domain-separated SHA-256 Merkle tree proofs (0x00 leaf / 0x01 internal node), RFC 8032 Ed25519 digital signatures (216-byte wwpkg_signature_t), and a 6-step CreatorPackagingWizard in wwal-studio.
  • Deterministic 4-Tier Wallpaper Engine Compatibility Scanner (we_compat_scanner): Pre-apply static & AST analyzer for PKGV0001..PKGV0024 archives with rolling XOR de-masking, PE/ELF/Zip-Slip quarantine, 6-pass scene.json / GLSL ES 3.10 AST auditing, automatic shader repair (highp float, HLSL-to-GLSL intrinsics, fragColor.a = 1.0), and a QuickJS instruction/memory watchdog (<= 2.0 ms, 16 MiB heap, 100,000 opcodes).
  • Extended Daemon IPC Protocol (0x0019..0x001C, 0x8008..0x800B): Added WAYWAL_REQ_SCAN_COMPAT, WAYWAL_REQ_INSTALL_WWPKG, WAYWAL_REQ_QUERY_WORKSHOP_STATUS, and WAYWAL_REQ_RELOAD_WORKSHOP_SCENE with zero-copy DMA-BUF output export (WAYWAL_REQ_EXPORT_OUTPUT_DMABUF) prioritizing active video engines.

Fixed

  • VA-API H.264 B-Frame Reorder Buffer & VUI Parsing (vaapi_h264.c, video_engine.c): Fixed constraint_set0_flag vs constraint_set1_flag bit extraction, parsed H.264 SPS VUI bitstream_restriction_flag / max_num_reorder_frames, expanded WAYWAL_VIDEO_REORDER_CAP to 17 frames, prevented premature B-frame reorder buffer draining acrossPOC gaps (poc <= ve->next_present_poc), eliminated loop-boundary decode stalls (looped_this_tick), and fixed VPP round-robin surface selection on NVIDIA.
  • VBlank PLL Phase-Locking & Frame Pacing (video_engine.c, presentation.c): Sampled CLOCK_MONOTONIC after synchronous GPU/VPP blits, aligned PLL vblank predictions past the current frame boundary to prevent 8 ms / 23 ms frame-repeat oscillations, replaced superseded wp_presentation_feedback requests on back-to-back commits, and cached /proc/self/smaps_rollup reads in ipc_server.c (500 ms TTL) so wwal-studio telemetry polling never stalls the render loop.
  • Hyprland Fullscreen Layer-Surface Recovery (layer_shell.c, wayland_core.c, main.c): Automatically recreates and remaps zwlr_layer_surface_v1 background surfaces that were initially mapped behind a fullscreen window (out->pres_sync.pll.frame_seq == 0) as soon as fullscreen exits or the active workspace changes, working around Hyprland's CLayerSurface::onMap m_alpha = 0 skip.

WayWal v1.2.0

Choose a tag to compare

@Execorn Execorn released this 30 Oct 12:10

Added

  • Hardware TMU Noise Intrinsics (u_noise_tex): Persistent 256×256 GL_RGBA8 bilinear wrap-repeat noise LUT bound to GL_TEXTURE5 with golden-ratio channel offsets (G = R(x+37, y+17), B = R(x+113, y+53)) and built-in waywal_noise2d, waywal_noise2d_dual, and waywal_noise3d GLSL helpers in both fragment and compute shader prologues.
  • Multi-Rate & Sub-Resolution BUFFER_A..D Passes: Added @wwal_buffer_scale (0.1–1.0) and @wwal_buffer_fps (0–240, with 0 baking static buffer passes once on frame 0 or resize) comment annotations and #pragma waywal directives for multi-pass Shadertoy shaders.
  • Multi-Resolution Transition Scratch Pool: Added a 4-slot resolution-keyed GL_RGBA8 scratch texture pool in gpu_compute.c for zero-thrash mixed-resolution multi-monitor (1080p + 1440p + 4K) transitions.

Fixed

  • Fixed OpenGL ES 3.1 smoothstep(edge0, edge1, x) inverted-edge undefined behavior (edge0 >= edge1) across all 10 built-in .frag shader presets and 10 .comp transition shaders (burn, ripple, slide, page_curl, pixelate, luma, wipe, wave, fade, doom).
  • Fixed multi-monitor image transition state cache invalidation when switching scratch resolutions across outputs (ensure_10bit_scratch_target and blit_scratch_to_10bit_bo).
  • Fixed cross-monitor Wayland pointer coordinate derivation (daemon_query_cursor_pos) and applied smoothed AGC gain (fft->current_gain) in waywal_audio_get_effective_volume.

Performance

  • Up to 5.68× Faster Built-In Shaders & 46% Lower Multi-Monitor GPU Power: Replaced multi-octave procedural ALU noise and sin() hashes with hardware TMU waywal_noise2d / waywal_noise2d_dual fetches, hoisted loop-invariant trigonometric rotation matrices out of raymarching and layer loops, added transmittance early-exit in aurora.frag (2.55 ms → 0.45 ms at 1080p, 28.5 W → 15.5 W across 3 monitors), analytic bounding-sphere ray pre-culling in plasma_orb.frag, and $O(1)$ active-bar indexing in audio_bars.frag and audio_ring.frag.
  • Same-Resolution Multi-Monitor Shader Clone Blit: Outputs sharing identical resolutions and a mouse-independent shader now blit the rendered texture (waywal_shader_engine_blit_bo) instead of re-executing the fragment/compute shader per monitor.
  • Zero-Stall GLES 3.1 Driver Dispatch: Eliminated per-frame glGetIntegerv driver stalls in shader_engine.c and we_tex.c, gated unused glGenerateMipmap, iDate localtime_r, audio_tex uploads, and _rt_imageLayerComposite FBO blits in we_scene.c, eliminated 60 Hz Hyprland cursor IPC polling for mouse-independent shaders, and batched wl_display_flush once per frame tick.

WayWal v1.1.0

Choose a tag to compare

@Execorn Execorn released this 30 Oct 12:04

Added

  • Native Wallpaper Engine Workshop runtime (we_pkg.c, we_tex.c, we_puppet.c, we_shader.c, we_scene.c, we_particle.c, we_script.c): zero-extraction mmap PKGV0001..22 archives, hardware BC1/BC2/BC3/BC7 and LZ4 TEXV0005 textures, 2D Puppet Warp skeletal .mdl meshes, AVX2 Structure-of-Arrays particle simulation, multi-pass GLSL effect chains, sandboxed SceneScript VM, and wwal workshop list / info / apply.
  • Multi-pass Shadertoy rendering (Buffer A..Buffer D GL_RGBA16F ping-pong passes, iChannel0..iChannel3 bindings, #pragma waywal, hardware derivatives, iMouse, iDate, and live u_palette_* uniforms).
  • 2.5D depth-map parallax wallpaper mode (--depth-map <PATH> and --depth-strength <FLOAT>) and Wayland cursor and workspace-slide spring parallax.
  • Universal live-to-live cross-mode GPU transitions across static images, hardware videos, live shaders, and Workshop scenes, plus panoramic --scaling-mode span.
  • Event-driven D-Bus MPRIS2 integration (mpris.c) exposing u_album_art, u_media_playing, u_media_position, u_media_Color0..4, and --theme-from-media dynamic album art theming.
  • PipeWire background audio volume control and automatic external playback ducking (--volume, --mute-on-audio, wwal audio).
  • Rich JSON IPC inspection (wwal status [--json], wwal query --json, wwal stats --json), live uniform and Workshop property mutation (wwal set-uniform), and newline-delimited JSON event streaming (wwal subscribe).
  • zwlr_foreign_toplevel_manager_v1 occlusion tracking (protocols/wlr-foreign-toplevel-management-unstable-v1.xml) and --battery-policy CLI flag.
  • WebM EBML_ID_DURATION parsing, Xiph/Fixed/EBML block lacing expansion, and MP4 ctts v0/v1 composition time offset support in demuxer.c.
  • --version / -V / version CLI support in wwal and wwald wired to meson.project_version(), plus contrib/config.toml.example and starter GLSL shaders (contrib/shaders/plasma.frag, contrib/shaders/audio_spectrum.frag).

Fixed

  • Backward-compatible IPC header parsing in WAYWAL_REQ_SET_IMAGE for legacy waywal_img_metadata_t payloads.
  • Deduplicated client/daemon HCT palette extraction, theme file exports, /dev/pts/* broadcasts, and hook execution on wwal img, while wiring daemon-side theme/hook updates and SIGHUP directory rescanning into slideshow.c.
  • Preserved per-effect wave/blur defaults in crosszoom, slide, glitch, burn, ripple, and wave, fixed --transition-type simple and random, and eliminated double Cubic-Bezier easing.
  • Added in_flight poll SQE tracking in uring_loop.c and forced epoll/io_uring re-registration on compositor IPC reconnect.
  • Wired meson_options.txt feature toggles (WWAL_DISABLE_{WEBP,AVIF,JXL,SVG,PIPEWIRE,SIMD}) across runtime dlopen loaders and SIMD dispatch tables, and removed the unused shaderc build dependency.
  • Hardened VA-API H.264/HEVC/VP9/AV1 bitstream parsers (pred_weight_table, multi-command RPLM, dependent slice inheritance, per-slot AV1 PrevGmParams/loop-filter/segmentation persistence, and hidden alt-ref frame suppression), multi-plane NV12/P010 GPU video transition snapshots, EGLImage per-scene BO tracking, and Seccomp-BPF / SceneScript / JSON / .pkg bounds safety.

Performance

  • Vectorized AVX2 and AVX-512 BW scanline alpha blending without per-scanline _mm_sfence() stalls, cached GLSL uniform locations across all 19 transition compute shaders and Wallpaper Engine passes, and eliminated redundant 4K RGBA heap buffers in video_engine.c, we_tex.c, and main.c.
  • Added AVX2-accelerated Annex-B start-code / RBSP unescaping, AVX2 FMA3 turbulent curl-noise and skeletal puppet skinning, hoisted OKLab cbrtf out of K-Means inner loops, gated PipeWire FFT and Hyprland cursor IPC on active shader consumers, and added zero-fork ISO-BMFF/WebM stream probing before ffmpeg transcoding.
  • Reclaimed source_old_bo DMA-BUFs immediately upon transition completion and released GL_RGBA16F multi-pass ping-pong and scratch textures when stopping shader playback, reducing steady-state VRAM consumption by ~32–96 MB per 4K output.
  • Consolidated image_loader.c, we_pkg.c, we_json.c, and we_project.c into libwaywal_common.a and decomposed video_vaapi.c, we_scene.c, main.c, we_script.c, and render_engine.c into focused modules.

WayWal v1.0.0

Choose a tag to compare

@Execorn Execorn released this 26 Oct 08:50

Changelog

All notable changes to this project are documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

1.0.0 - 2026-10-26

Added

  • Wayland Core & Direct Scanout (wwald):
    • zwp_linux_dmabuf_v1 v4 surface feedback negotiation supporting linear and tiled GPU modifiers (NVIDIA Block-Linear, AMD DCC, Intel CCS, ARM AFBC) and 10-bit wide-gamut formats (XRGB2101010 / ARGB2101010).
    • wp_single_pixel_buffer_v1 1x1 solid color scanout (wwal clear / wwal color).
    • wp_fractional_scale_v1 and wp_viewporter physical HiDPI rendering (scale_120) without compositor upscaling blur.
    • wp_presentation VBlank Phase-Locked Loop (PLL) for tear-free frame pacing on fixed-refresh and VRR displays.
    • Secondary zwlr_layer_surface_v1 overview backdrop surface (--backdrop auto-blur) using a 2-pass Dual-Kawase compute blur for Niri and scrollable tiling compositors.
    • Multi-GPU render-node discovery with linear PRIME export fallback and hotplug-safe wl_output lifecycle management.
  • GPU Compute & CPU SIMD Transition Engine:
    • 18 OpenGL ES 3.1 compute shader transitions (fade, wipe, grow, outer, wave, noise, crosszoom, slide, glitch, burn, ripple, pixelate, doom, swirl, cube, luma, light_leak, page_curl) plus custom .comp shader loading (--transition-shader).
    • Multi-threaded OpenMP + runtime-dispatched AVX-512 (vbmi2), AVX2, NEON, and scalar CPU transition kernels.
    • Aspect-ratio scaling modes (fill, fit, stretch, center, tile) with Lanczos3, Mitchell, Catmull-Rom, Bilinear, and Nearest resampling filters.
  • Zero-FFmpeg Hardware Video & Native Animation Engine:
    • In-process MP4/ISOBMFF and WebM/Matroska EBML zero-allocation demuxers (demuxer.c).
    • Hardware VA-API (libva) decoding for H.264, HEVC (Main & Main10), VP9 (Profile 0 & 2), and AV1 (Main Profile) with direct NV12/P010 DMA-BUF export on AMD/Intel and a 3-surface BGRX VPP ring on NVIDIA.
    • Native in-process delta-frame animation engine (anim_engine.c) for animated GIF, APNG, and animated WebP without external transcoding dependencies.
  • Live Shadertoy & PipeWire Audio-Reactive Engine:
    • Live GLSL ES 3.1 .comp and Shadertoy .frag wallpaper engine (wwal shader) with OES_get_program_binary disk caching and inotify hot-reload on file save.
    • Lock-free PipeWire audio capture and 2048-point Hann-windowed AVX2 radix-2 FFT producing 64-bin Bark-scale spectrum uniforms and an iChannel0 audio texture (--audio).
  • Material Design 3 (OKLab / CAM16 / HCT) Theme Engine:
    • Sub-millisecond AVX2 Wu 3D variance quantization and weighted K-Means++ palette extraction (wwal theme / --theme).
    • Automatic generation of 29 Material Design 3 dark and light role tokens synced to ~/.local/state/caelestia/scheme.json (Quickshell), ~/.cache/wwal/colors.{json,css,hyprland.conf}, and active /dev/pts/* terminal emulators via non-blocking OSC 4/10/11 sequences.
  • Zero-Watt Power & Occlusion Governor:
    • Automatic 0.00% CPU/GPU timer disarmament when a monitor is occluded by a fullscreen or maximized window (ext-foreign-toplevel-list-v1 + Hyprland/Sway IPC sockets), when the user session is idle (ext-idle-notify-v1), or on laptop battery power (/sys/class/power_supply).
  • Client CLI, Persistence & Sandbox Hardening:
    • Drop-in CLI compatibility when invoked as swww, swww-daemon, awww, or awww-daemon.
    • Support for PNG, JPEG, BMP, WebP, AVIF (including multi-frame macOS Solar Dynamic schedules), JPEG-XL, GIF, APNG, and SVG.
    • CRC32-verified binary state persistence (state.bin), declarative ~/.config/wwal/config.toml parser with per-output and per-workspace rules, and real-time telemetry (wwal stats).
    • Linux io_uring event loop (uring_loop.c) and Seccomp-BPF + Landlock v3 process sandboxing (security.c).