User guide (written for this page)

This is the browser-side test bench of wallpaper-engine-web-loader: one static page plus WebGL2 renders Wallpaper Engine scene.pkg / .mpkg wallpapers live — no Wallpaper Engine install, no Windows dependencies. This repository redistributes no real wallpaper; the default is a synthetic sample we generate ourselves.

Reading the layout

Three steps to start

1. Top Settings → Language; the Theme row gives two explicit switches (dark / light — there is no “follow system” mode any more), and the sun/moon button toggles between the two.
2. Wallpaper: the synthetic sample is already loaded; use “Choose folder” for your own (read in-browser, files never leave it).
3. Tune: wallpaper-specific knobs on the left, runtime knobs (resolution / FPS / volume) in “Settings 1”.

Wallpaper switcher (above “Settings 1”)

The current wallpaper is the first tab (its title is the wallpaper name); further tabs are generated from the library by this page's patch, and the ＋ at the right jumps to “choose another wallpaper” — it switches the left list to “Choose wallpaper”, filters out the current item, and one click there performs the switch.

Wallpaper settings (third tab)

The table pairs Wallpaper Engine's own wallpaper options (flip / playback rate / colour options: brightness, contrast, saturation, hue shift …) with how this page changes them: an API, a JSON key or a query parameter where one exists; “built-in, nothing to implement” where Wallpaper Engine already owns it.

What the online (GitHub Pages) build lacks

Online is plain static hosting with no local Node backend, so the library listing, property saving, deleting, reveal-in-folder and the diagnostics stream (/api/*, /diag) are unavailable — by design, not a failure; those controls are greyed out with the reason shown. “Choose folder” still works and the default wallpaper remains the synthetic sample. For the full bench run node server/we-scene-demo-server.mjs 8899 in the source tree.

Licence & attribution

• This repository's renderer: GPL-3.0-or-later; third-party components are itemised in THIRD-PARTY.md.
• Naming note: this product is now called WEwebLoader; the upstream project is still WebWallGL (oneincase/webwallgl, MIT) — its attribution and licence are unchanged.
• This page is a patched redistribution of the WebWallGL static build by oneincase/webwallgl (MIT © 2026 oneincase); both licence copies ship with the page: LICENSE-webwallgl-MIT.txt, LICENSE-webwallgl.
• Icons: Lucide (ISC). The synthetic sample is generated by tools/make-sample.mjs and carries no third-party content.

Wallpaper settings ↔ the API that changes them

Three sources, kept apart: WE built-in (nothing for us to implement), implemented here (the API you can call today), to implement (agreed key names and the hook point). The toggles in “Settings 1” are this page's implementation surface; the items in “Wallpaper parameters” come from the wallpaper's own project.json.

1. Wallpaper Engine's own wallpaper options

2. The wallpaper's own properties (project.json → general.properties)

3. Runtime parameters (not WE's, but the usual debugging knobs)

4. Try it yourself

// Browser console (pick a wallpaper first and wait for __wp)
const wp = document.querySelector('#frame').contentWindow.__wp
wp.setDisplay({ brightness: 1.15, contrast: 1.05, saturation: 1.2, hue: 12 })
wp.setDisplay({ flipH: true })
wp.setPlaybackRate(1.5)
wp.setVolume(0.4)
wp.pushPointer(0.5, 0.5)

Rows marked to implement are the key names this page will wire next (documented first as a contract; when implemented the status flips to “implemented” and a gate covers it). Wallpaper Engine's own options need no code from us.