Repository navigation
Releases
Releases · Execorn/wwal
WayWal v3.0.0
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 hybridfanotify(FAN_MARK_FILESYSTEM) and recursiveinotifywatcher withepoll+timerfd300 ms debounce and 1,000 ms flush ceiling. - Embedded SQLite3 WAL + FTS5 Catalog Index: Sub-millisecond (
< 0.1 msat 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.soISteamUGC runtimedlopen, Steam Web API + HTTP/2 byte-range resume worker with full-jitter HTTP 429 backoff, and asynchronoussteamcmdpipe runner) governed by a Token Bucket bandwidth limiter and EWMA speed/ETA estimator. - WayWal Open Hub & Cryptographic
.wwpkgEcosystem: Open.wwpkg(tar.zst) wallpaper package container with RFC 8785 JSON Canonicalization Scheme (JCS), RFC 6962 domain-separated SHA-256 Merkle tree proofs (0x00leaf /0x01internal node), RFC 8032 Ed25519 digital signatures (216-bytewwpkg_signature_t), and a 6-stepCreatorPackagingWizardinwwal-studio. - Deterministic 4-Tier Wallpaper Engine Compatibility Scanner (
we_compat_scanner): Pre-apply static & AST analyzer forPKGV0001..PKGV0024archives with rolling XOR de-masking, PE/ELF/Zip-Slip quarantine, 6-passscene.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 MiBheap,100,000opcodes). - Extended Daemon IPC Protocol (
0x0019..0x001C,0x8008..0x800B): AddedWAYWAL_REQ_SCAN_COMPAT,WAYWAL_REQ_INSTALL_WWPKG,WAYWAL_REQ_QUERY_WORKSHOP_STATUS, andWAYWAL_REQ_RELOAD_WORKSHOP_SCENEwith 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): Fixedconstraint_set0_flagvsconstraint_set1_flagbit extraction, parsed H.264 SPS VUIbitstream_restriction_flag/max_num_reorder_frames, expandedWAYWAL_VIDEO_REORDER_CAPto17frames, 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): SampledCLOCK_MONOTONICafter synchronous GPU/VPP blits, aligned PLL vblank predictions past the current frame boundary to prevent8 ms/23 msframe-repeat oscillations, replaced supersededwp_presentation_feedbackrequests on back-to-back commits, and cached/proc/self/smaps_rollupreads inipc_server.c(500 msTTL) sowwal-studiotelemetry polling never stalls the render loop. - Hyprland Fullscreen Layer-Surface Recovery (
layer_shell.c,wayland_core.c,main.c): Automatically recreates and remapszwlr_layer_surface_v1background 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'sCLayerSurface::onMapm_alpha = 0skip.
WayWal v1.2.0
Added
- Hardware TMU Noise Intrinsics (
u_noise_tex): Persistent256×256GL_RGBA8bilinear wrap-repeat noise LUT bound toGL_TEXTURE5with golden-ratio channel offsets (G = R(x+37, y+17),B = R(x+113, y+53)) and built-inwaywal_noise2d,waywal_noise2d_dual, andwaywal_noise3dGLSL helpers in both fragment and compute shader prologues. - Multi-Rate & Sub-Resolution
BUFFER_A..DPasses: Added@wwal_buffer_scale(0.1–1.0) and@wwal_buffer_fps(0–240, with0baking static buffer passes once on frame0or resize) comment annotations and#pragma waywaldirectives for multi-pass Shadertoy shaders. - Multi-Resolution Transition Scratch Pool: Added a 4-slot resolution-keyed
GL_RGBA8scratch texture pool ingpu_compute.cfor 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.fragshader presets and 10.comptransition 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_targetandblit_scratch_to_10bit_bo). - Fixed cross-monitor Wayland pointer coordinate derivation (
daemon_query_cursor_pos) and applied smoothed AGC gain (fft->current_gain) inwaywal_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 TMUwaywal_noise2d/waywal_noise2d_dualfetches, hoisted loop-invariant trigonometric rotation matrices out of raymarching and layer loops, added transmittance early-exit inaurora.frag(2.55 ms→0.45 msat1080p,28.5 W→15.5 Wacross 3 monitors), analytic bounding-sphere ray pre-culling inplasma_orb.frag, and$O(1)$ active-bar indexing inaudio_bars.fragandaudio_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
glGetIntegervdriver stalls inshader_engine.candwe_tex.c, gated unusedglGenerateMipmap,iDatelocaltime_r,audio_texuploads, and_rt_imageLayerCompositeFBO blits inwe_scene.c, eliminated 60 Hz Hyprland cursor IPC polling for mouse-independent shaders, and batchedwl_display_flushonce per frame tick.
WayWal v1.1.0
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-extractionmmapPKGV0001..22archives, hardwareBC1/BC2/BC3/BC7andLZ4TEXV0005textures, 2D Puppet Warp skeletal.mdlmeshes, AVX2 Structure-of-Arrays particle simulation, multi-pass GLSL effect chains, sandboxedSceneScriptVM, andwwal workshop list / info / apply. - Multi-pass Shadertoy rendering (
Buffer A..Buffer DGL_RGBA16Fping-pong passes,iChannel0..iChannel3bindings,#pragma waywal, hardware derivatives,iMouse,iDate, and liveu_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
MPRIS2integration (mpris.c) exposingu_album_art,u_media_playing,u_media_position,u_media_Color0..4, and--theme-from-mediadynamic 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_v1occlusion tracking (protocols/wlr-foreign-toplevel-management-unstable-v1.xml) and--battery-policyCLI flag.- WebM
EBML_ID_DURATIONparsing, Xiph/Fixed/EBML block lacing expansion, and MP4cttsv0/v1 composition time offset support indemuxer.c. --version/-V/versionCLI support inwwalandwwaldwired tomeson.project_version(), pluscontrib/config.toml.exampleand starter GLSL shaders (contrib/shaders/plasma.frag,contrib/shaders/audio_spectrum.frag).
Fixed
- Backward-compatible IPC header parsing in
WAYWAL_REQ_SET_IMAGEfor legacywaywal_img_metadata_tpayloads. - Deduplicated client/daemon HCT palette extraction, theme file exports,
/dev/pts/*broadcasts, and hook execution onwwal img, while wiring daemon-side theme/hook updates andSIGHUPdirectory rescanning intoslideshow.c. - Preserved per-effect wave/blur defaults in
crosszoom,slide,glitch,burn,ripple, andwave, fixed--transition-type simpleandrandom, and eliminated double Cubic-Bezier easing. - Added
in_flightpoll SQE tracking inuring_loop.cand forcedepoll/io_uringre-registration on compositor IPC reconnect. - Wired
meson_options.txtfeature toggles (WWAL_DISABLE_{WEBP,AVIF,JXL,SVG,PIPEWIRE,SIMD}) across runtimedlopenloaders and SIMD dispatch tables, and removed the unusedshadercbuild dependency. - Hardened VA-API H.264/HEVC/VP9/AV1 bitstream parsers (
pred_weight_table, multi-command RPLM, dependent slice inheritance, per-slot AV1PrevGmParams/loop-filter/segmentation persistence, and hidden alt-ref frame suppression), multi-planeNV12/P010GPU video transition snapshots, EGLImage per-scene BO tracking, and Seccomp-BPF /SceneScript/ JSON /.pkgbounds 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 invideo_engine.c,we_tex.c, andmain.c. - Added AVX2-accelerated Annex-B start-code / RBSP unescaping, AVX2 FMA3 turbulent curl-noise and skeletal puppet skinning, hoisted
OKLabcbrtfout 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 beforeffmpegtranscoding. - Reclaimed
source_old_boDMA-BUFs immediately upon transition completion and releasedGL_RGBA16Fmulti-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, andwe_project.cintolibwaywal_common.aand decomposedvideo_vaapi.c,we_scene.c,main.c,we_script.c, andrender_engine.cinto focused modules.
WayWal v1.0.0
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_v1v4 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_v11x1 solid color scanout (wwal clear/wwal color).wp_fractional_scale_v1andwp_viewporterphysical HiDPI rendering (scale_120) without compositor upscaling blur.wp_presentationVBlank Phase-Locked Loop (PLL) for tear-free frame pacing on fixed-refresh and VRR displays.- Secondary
zwlr_layer_surface_v1overview 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_outputlifecycle 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.compshader 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.
- 18 OpenGL ES 3.1 compute shader transitions (
- 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 directNV12/P010DMA-BUF export on AMD/Intel and a 3-surfaceBGRXVPP ring on NVIDIA. - Native in-process delta-frame animation engine (
anim_engine.c) for animated GIF, APNG, and animated WebP without external transcoding dependencies.
- In-process MP4/ISOBMFF and WebM/Matroska EBML zero-allocation demuxers (
- Live Shadertoy & PipeWire Audio-Reactive Engine:
- Live GLSL ES 3.1
.compand Shadertoy.fragwallpaper engine (wwal shader) withOES_get_program_binarydisk caching andinotifyhot-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
iChannel0audio texture (--audio).
- Live GLSL ES 3.1
- 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.
- Sub-millisecond AVX2 Wu 3D variance quantization and weighted K-Means++ palette extraction (
- 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).
- Automatic 0.00% CPU/GPU timer disarmament when a monitor is occluded by a fullscreen or maximized window (
- Client CLI, Persistence & Sandbox Hardening:
- Drop-in CLI compatibility when invoked as
swww,swww-daemon,awww, orawww-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.tomlparser with per-output and per-workspace rules, and real-time telemetry (wwal stats). - Linux
io_uringevent loop (uring_loop.c) and Seccomp-BPF + Landlock v3 process sandboxing (security.c).
- Drop-in CLI compatibility when invoked as