Repository navigation
WallForge 0.6.0
WallForge 0.6.0
New
- Wallpaper rotation: Settings > Playback changes the wallpaper every N minutes, at random or in library order,
optionally only through favourites and optionally with a different wallpaper on each screen.Ctrl+Shift+Nrotates
immediately.
Performance and battery
- Render resolution (Settings > Effects and power): scene wallpapers can be drawn at 25–100% of the screen size
and upscaled with one linear blit. Videos and web wallpapers are unaffected. - Battery saving: while discharging, the frame rate is capped at 30 fps and the render scale at 75% (on by
default); optionally pause every wallpaper on battery and resume when you plug in. - Web wallpapers follow the reduced frame rate too.
Compatibility
- Audio-reactive wallpapers: the system's audio output is captured (PipeWire/PulseAudio monitor, no microphone)
and fed to theg_AudioSpectrumuniforms, so visualisers and spectrum effects move with your music. Capture starts
only when a scene's shaders ask for it and can be turned off in Settings. - Text layers: effect chains (glow, outline, shadow) now run on text, point sizes match the wallpapers' previews, date/time
formatpatterns are expanded (strftime,
{year}-style and Cafe-styledd MMM yyyy), and a custom font that cannot be found is named in the log instead of
silently falling back. - Effect chains that use copy passes (a pass with no material),
#requiremodule directives, engine buffers such as
_alias_lightCookie, or JSON with trailing commas now load instead of being skipped. The fluid-simulation Gengar
wallpaper renders its full effect stack. - Effects can now sample another layer's rendered image (
_rt_imageLayerComposite_*), including layers that are
hidden in the scene. Shadow Keep's moon and the pixel-cyberpunk xray scene render their missing content instead of
a blurry or black area.
Stability
- Crash watchdog: a renderer that dies unexpectedly is restarted. After three restarts in five minutes the screen
is left idle with a "stopped after repeated crashes" note in the playing bar, instead of a restart loop.
Documentation
- README: "Performance and battery" section; renderer README documents
--scale. .coderabbit.yamlso pull requests are reviewed by CodeRabbit with project-specific hints.
Verified
- Every installed scene wallpaper except one 3D scene starts cleanly with nothing skipped (76 of 77 in the test library).
- The renderer test suite (25 tests), the Python unit tests and lint are green in CI.
Full changelog: https://github.com/pgm1207/WallForge/blob/main/CHANGELOG.md