Skip to content

Wallpaper Types

David Goree edited this page Jun 6, 2026 · 2 revisions

Wallpaper Types & Support Status

Wallpaper Engine ships three broad categories of wallpaper. The plugin's compatibility differs across them.

Scene (2D)

Supported by Vulkan 1.1. Requires Wallpaper Engine installed for assets. These are the animated, layered 2D scenes most Workshop wallpapers use — and the most polished playback path in the plugin.

See Scene Renderer for a full per-feature support matrix (layers, particles, effects, SceneScript, 3D models, audio, etc.).

Web

These render through QtWebEngine, which is Chromium underneath, so HTML, CSS, JS, and WebGL behave the way they would in a browser. In practice most Web wallpapers just work. Something built against a very new or unusual browser API might misbehave, but WebGL itself is fine.

Video

Plain video file looped as a background. The plugin offers two playback engines — see Video Backends.

What's not supported

  • 3D Scene wallpapers (rare in the Workshop) — the renderer focuses on the 2D scene format with limited 3D model support; see Scene Renderer → 3D Models.
  • Audio Visualizer category that relies on Windows-only audio paths may behave inconsistently, though the renderer has PipeWire/PulseAudio capture and FFT spectrum analysis built in.
  • Screen locking — KDE's lock screen uses its own greeter renderer, so the live wallpaper won't show on the lock screen. Set a static fallback in System Settings → Colours & Themes → Login Screen / Lock Screen.

Clone this wiki locally