Known Issues

Known Issues

From the project's README:

• Some Scene wallpapers may crash KDE. Remove the WallpaperSource line in ~/.config/plasma-org.kde.plasma.desktop-appletsrc and restart KDE to recover.
• Mouse long-press to enter panel edit mode is broken on desktop while a live wallpaper is running.
• Screen locking is not supported. The lock screen will show a static image, not the live wallpaper.

Recovering from a crash loop

If picking a Scene wallpaper kills plasmashell and it crashes again on every login:

1. Switch to a TTY (Ctrl+Alt+F2) or open KRunner.
2. Stop plasmashell so the config file isn't overwritten:

   systemctl --user stop plasma-plasmashell.service

3. Edit ~/.config/plasma-org.kde.plasma.desktop-appletsrc and delete any line beginning with WallpaperSource=. Optionally set Image= to a plain image path in the same [Wallpaper] block to guarantee a static fallback.
4. Restart Plasma:

   systemctl --user start plasma-plasmashell.service

Panel edit mode

Long-press on the desktop to bring up Plasma's edit overlay does not work while a live wallpaper is running.

Workaround: use the desktop toolbox icon (the hamburger in the corner) or right-click → Enter Edit Mode.

Screen locking

When the screen is locked, KDE uses its own greeter renderer that doesn't load this plugin. Your lock screen will show a static image (set in System Settings → Colours & Themes → Login Screen / Lock Screen), not the live wallpaper.

Web wallpapers with heavy WebGL

The plugin's web view supports basic web APIs, but WebGL may not work properly. Workshop wallpapers that depend on it (custom shaders rendered through WebGL canvases, three.js scenes) often render as a black screen or with glitches. Prefer the Scene or Video version if the author published one.